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 за ваш счет.
Стоимость
Каждый вызов платный, вне зависимости от того, удалось определить координаты или нет.