API Спутник/КартыСервис геокодирования

Сервис геокодирования

Сервис геокодирования позволяет получить географические координаты объекта по его адресу.

Сервис обрабатывает HTTP GET-запросы и отвечает в формате JSON.

Сервис отвечает на запросы вида

http://search.maps.sputnik.ru/search/addr?<параметры запроса>

Параметры запроса

имя параметра описание пример
q адрес искомого объекта (обязательный параметр) Москва, Тверская улица 13
tlat, tlon, blat, blon Координаты(top, bottom) bbox текущей области поиска ?blat=55.8019382685528&blon=37.41110801696777&tlat=55.80501053434683&tlon=37.402862906455994
strict Искать только в заданном прямоугольнике (bbox) true
callback имя callback-функции для запроса в форме JSONP jsonp_123
addr_limit максимальное количество результатов 10
format формат выдачи данных (JSON или XML) xml
apikey API-ключ 5032f91e8da6431d8605-f9c0c9a00357

Ответ сервиса

Сервис отвечает в формате JSON и возвращает результат следующего вида:


{
  meta: {
    version: "0.177.0",
    format: "geojson"
  },
  result: {
    priority: "address",
    address: [
      {
        type: "FeatureCollection",
        features: [
          {
            type: "Feature",
            properties: {
              id: 11493114,
              type: "house",
              description: "Россия, Москва",
              display_name: "Россия, Москва, Тверская улица, 13",
              title: "Тверская улица, 13",
              address_components: [
                {
                  type: "country",
                  value: "Россия"
                },
                {
                  type: "place",
                  value: "Москва"
                },
                {
                  type: "street",
                  value: "Тверская улица"
                }
              ],
              fias_id: "5032f91e-8da6-431d-8605-f9c0c9a00357",
              full_match: true
            },
            geometry: {
              type: "GeometryCollection",
              geometries: [
                {
                  type: "Point",
                  coordinates: [
                    37.608074,
                    55.76125
                  ]
                }
              ]
            }
          }
        ]
      }
    ]
  }
}

Пример запроса http://search.maps.sputnik.ru/search?q=Москва,%20Тверская%20улица%2013

Сервис геокодирования (старый формат ответа)

Сервис геокодирования позволяет получить географические координаты объекта по его адресу.

Сервис обрабатывает HTTP GET-запросы и отвечает в формате GeoJSON.

Сервис отвечает на запросы вида

http://search.maps.sputnik.ru/search?<параметры запроса>

Параметры запроса

имя параметра описание пример
q адрес искомого объекта (обязательный параметр) Москва, Тверская улица 13
vlat широта предполагаемого местоположения 55.76228158365787
vlon долгота предполагаемого местоположения 37.854766845703125
callback имя callback-функции для запроса в форме JSONP jsonp_123
limit максимальное количество результатов 10
apikey API-ключ 5032f91e8da6431d8605-f9c0c9a00357

Ответ сервиса

Сервис отвечает в формате JSON и возвращает результат следующего вида:


    {
    "result": [
        {
            "description": "Россия, Москва",
            "display_name": "Тверская улица, 13, Россия, Москва",
            "fias_id": "5032f91e-8da6-431d-8605-f9c0c9a00357",
            "position": {"lat": 55.761248, "lon": 37.608074},
            "title": "Тверская улица, 13",
            "type": "house"
        }
    ]
    }

Пример запроса http://search.maps.sputnik.ru/search?q=Москва,%20Тверская%20улица%2013

Сервис обратного геокодирования

Сервис обратного геокодирования позволяет получить информацию об объекте по его координатам. Возвращается найденный объект в иерархии административного деления. Возвращается наиболее точный результат. Точность определяется в следующем порядке: область, район, город, район города, здание (см. параметр houses).

Сервис обрабатывает HTTP GET-запросы и отвечает в формате JSON.

Сервис отвечает на запросы вида

http://whatsthere.maps.sputnik.ru/point?<параметры запроса>

Параметры запроса

имя параметра описание пример
lat широта 55.76228158365787
lon долгота 37.854766845703125
houses true - поиск до здания, false - до района города true
callback имя callback-функции для запроса в форме JSONP jsonp_123
apikey API-ключ 5032f91e8da6431d8605-f9c0c9a00357