Обратное геокодирование (reverse)

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

curl -X POST https://gdegeo.ru/api/v1/reverse \ -d "secret_key=01|dS5jNvcL0WBtRqAX5thFzBf9kHsHHOycmZrMWYt3385a3b6&lat=55.755501&lon=37.617989"

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

Параметр Обязательность Возможные значения Значения по умолчанию Описание
secret_key (обязательно) нет Секретный ключ вашего проекта
lat (обязательно) нет Значение широты
lon (обязательно) нет Значение долготы
format (не обязательно) xml, json, jsonv2, geojson, geocodejson jsonv2 Формат возвращаемых данных

Пример ответа: (jsonv2)

{
"place_id": 16444451,
"licence": "Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
"osm_type": "relation",
"osm_id": 5963922,
"lat": "55.75532295",
"lon": "37.61788152617616",
"place_rank": 30,
"category": "tourism",
"type": "museum",
"importance": 0,
"addresstype": "tourism",
"name": "Исторический музей",
"display_name": "Исторический музей, 1, Красная площадь, 4, Китай-город, Тверской район, Москва, Центральный федеральный округ, 109012, Россия",
"address": {
"tourism": "Исторический музей",
"house_number": "1",
"road": "Красная площадь",
"quarter": "4",
"neighbourhood": "Китай-город",
"suburb": "Тверской район",
"city": "Москва",
"state": "Москва",
"ISO3166-2-lvl4": "RU-MOW",
"region": "Центральный федеральный округ",
"postcode": "109012",
"country": "Россия",
"country_code": "ru"
},
"boundingbox": [
"55.7547969",
"55.7558482",
"37.6167918",
"37.618658"
]
}

Описание полей

Параметр Видимость Описание
place_id всегда Идентификатор места
licence всегда Лицензия
osm_type всегда Тип OSM объекта.
osm_id всегда Идентификатор OSM объекта.
lat всегда Широта
lon всегда Долгота
place_rank всегда Масштаб объекта.
28-30 - номера дома. 26-27 - улица, 25 - площади, фермы, местности, 22-24 - район, 17-21 - пригород, 13-16 - город, 10-12 - область, 5-9 - государство, 4 - страна
category всегда Категория места
type всегда Тип места
importance всегда Важность места
addresstype всегда Тип адреса (village - деревня, tourism - туристическое место, amenity - удобство / тц, leisure - досуг)
name всегда Название места / района / улицы и т.п.
display_name всегда Полное наименование адреса
Адрес (address)
county ситуативно Район (пример. Белоярский район)
state ситуативно Субъект (пример. Ханты-Мансийский автономный округ — Югра)
ISO3166-2-lvl4 всегда Международный стандарт коротких и уникальных алфавитно-цифровых геокодов (пример. RU-MOW)
region всегда Округ (пример. Уральский федеральный округ)
country всегда Страна (пример. Россия)
country_code всегда Код страны (пример. ru)
postcode ситуативно Индекс места (пример. 109012)
city ситуативно Город (пример. Москва)
suburb ситуативно Район (пример. Тверской район)
neighbourhood ситуативно Микрорайон (пример. Китай-город)
quarter ситуативно Квартал (пример. 4)
road ситуативно Улица (пример. улица Пушкина)
house_number ситуативно Номер дома (пример. 6В)
address_name всегда Название места. Иногда может быть null

Возможные ошибки

Коды ответов Сообщение Описание
400 В запросе отсутствует секретный ключ! В запросе отсутствует параметр secret_key (широта). Для исправления укажите этот параметр.
401 Секретный ключ не верен! В ключе ошибка или он не верен. Перепроверьте свой ключ, или перегенерируйте в кабинете проекта.
424 Не передана широта (lat) В запросе отсутствует параметр lat (широта). Для исправления укажите этот параметр.
424 Не передана долгота (lon) В запросе отсутствует параметр lon (долгота). Для исправления укажите этот параметр.
404 Координаты вне диапазона Координаты не корректны или отсутствуют в нашей базе.
403 У вас нет активного тарифа. Вероятно не оплачен тариф