↑ Все API

API: обратное геокодирование (адрес по координатам)

Находит ближайшие адреса (дома, улицы, города) по географическим координатам. Только для России.

Это документация для разработчиков. Определить адрес в демоформе, посмотреть сценарии использования и варианты подключения сервиса можно на странице «Найти адрес по координатам»

Как вызвать

Чтобы вызвать метод, и подтвердите почту.

Пример запроса:

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/geolocate/address
            
            
{ "lat": 55.878, "lon": 37.653 }

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

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

НазваниеТипОбяз.?По умолч.Описание
latnumberГеографическая широта
lonnumberГеографическая долгота
countnumber10Количество результатов (максимум — 20)
radius_metersnumber100Радиус поиска в метрах (максимум – 1000)
languagestringruНа каком языке вернуть результат (ru / en)

Пример запроса с ограничением по радиусу в 50 м:

{
  "lat": 55.601983, "lon": 37.359486, "radius_meters": 50
}

Что в ответе

Ответ:

{
    "suggestions": [
        {
            "value": "г Москва, ул Сухонская, д 11",
            "unrestricted_value": "127642, г Москва, ул Сухонская, д 11",
            "data": {...}
        },
        {
            "value": "г Москва, ул Сухонская, д 11А",
            "unrestricted_value": "127642, г Москва, ул Сухонская, д 11А",
            "data": {...}
        },
        {
            "value": "г Москва, ул Сухонская, д 13",
            "unrestricted_value": "127642, г Москва, ул Сухонская, д 13",
            "data": {...}
        },
        {
            "value": "г Москва, ул Сухонская, д 9",
            "unrestricted_value": "127642, г Москва, ул Сухонская, д 9",
            "data": {...}
        }
    ]
}

Адреса в ответе идут в порядке удаления от заданных координат.

У адреса обычный набор полей, но некоторые из них не заполняются:

city_area
city_district*
flat_*
timezone
beltway_hit
beltway_distance
metro

Покрытие координат

«Дадата» берет координаты домов и улиц из OpenStreetMap.

Покрытие по домам:

  • Москва — 97%,
  • Санкт-Петербург — 91%,
  • другие города-миллионники — 69%,
  • остальная Россия — 47%.

По улицам:

  • Москва — 95%,
  • Санкт-Петербург — 94%,
  • другие города-миллионники — 81%,
  • остальная Россия — 70%.

Примеры вызова

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

Метод бесплатный до 10 000 запросов в день. Больше — в составе годовой подписки.