↑ Все API

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

Определяет координаты адреса (дома, улицы, города). Только для России.

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

Как вызвать

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

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

            
                POST https://cleaner.dadata.ru/api/v1/clean/address
            
            
[ "москва сухонская 11" ]

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

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.
  • ${SECRET_KEY} — секретный ключ.

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

Что в ответе

Адрес с координатами:

[
{
    "source": "москва сухонская 11",
    "result": "г Москва, ул Сухонская, д 11",
    "postal_code": "127642",
    "country": "Россия",
    "region": "Москва",
    "city_area": "Северо-восточный",
    "city_district": "Северное Медведково",
    "street": "Сухонская",
    "house": "11",
    "geo_lat": "55.8782557",
    "geo_lon": "37.65372",
    "qc_geo": 0
}
]

Координаты возвращаются в полях geo_lat и geo_lon. Поле qc_geo показывает, насколько точно удалось определить координаты:

Код qc_geoОписание
0Точные координаты дома
1Ближайший дом
2Улица
3Населенный пункт
4Город
5Координаты не определены

Метод возвращает больше полей, чем показано в примере. Описание всех полей см. в API Стандартизации.

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

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

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

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

По улицам:

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

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

Ограничения

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

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

Дадата не поддерживает вызов этого метода из браузерного JavaScript. Иначе злоумышленник мог бы похитить секретный ключ и использовать API за ваш счет.

Стоимость

15 копеек за запись

Каждый вызов платный, вне зависимости от того, удалось определить координаты или нет.