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