API обратного геокодирования

Отправьте широту и долготу и получите ближайший адрес с отдельными полями для улицы, города, региона, почтового индекса и страны, а также расстояние от адреса до отправленной точки. Запросите более общий ответ с помощью level, если вам нужен только город или страна.

GEThttps://api.mygeocode.com/v1/reverse?lat=...&lon=...

Попробовать в демо Полный справочник

Пример

Запрос

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"

Точка находится в нескольких метрах от основания Эйфелевой башни. Ответ содержит ближайший почтовый адрес, а distance_m сообщает, что он в 12 м. Если бы ближайший адрес был в 400 м, например от точки в парке, вы бы тоже это увидели и могли бы решить показать вместо адреса район.

Добавьте level=city, чтобы пропустить адрес и сразу получить населённый пункт, или level=country для быстрого определения страны.

Ответ

{
  "status": "ok",
  "lat": 48.8584,
  "lon": 2.2945,
  "result": {
    "formatted": "5 Avenue Anatole France, 75007 Paris, France",
    "lat": 48.85837,
    "lon": 2.29448,
    "distance_m": 12,
    "type": "address",
    "precision": "house",
    "components": {
      "house_number": "5",
      "road": "Avenue Anatole France",
      "suburb": "7th Arrondissement",
      "city": "Paris",
      "state": "Ile-de-France",
      "postcode": "75007",
      "country": "France",
      "country_code": "fr"
    }
  }
}

Что вы получаете

Поле	Значение
`result.formatted`	Ближайший адрес в формате этой страны.
`result.lat`, `result.lon`	Положение самого адреса, а не отправленной вами точки.
`result.distance_m`	Расстояние в метрах между вашей точкой и адресом. Большое значение означает, что на самом деле вы находитесь не у адреса.
`result.precision`	`house`, `street`, `postcode` или `admin`, в зависимости от того, что есть рядом с точкой в этой стране.
`result.components`	Части адреса с теми же ключами, что и в прямом геокодировании.
`result` равен `null`	В радиусе 5 км от точки ничего нет. Открытый океан, Антарктида. Статус при этом всё равно `ok`.

Где это используется

Подписи к GPS-точкам

Превратите местоположение устройства в «рядом с Avenue Anatole France, 5» для журнала, квитанции или подписи к фото. Используйте distance_m, чтобы выбирать между «по адресу» и «рядом с».

Локальные настройки по умолчанию

Заполняйте заранее страну, валюту или язык по местоположению посетителя с помощью level=country. Используйте вместе с определением IP, если координат нет.

Доставка и выездная работа

Преобразуйте место, где водитель фактически остановился, в адрес и сравните его с адресом из заказа.

Цена и лимиты

Один вызов, один запрос. У каждого ключа есть 2 500 бесплатных запросов в день; сверх этого 0,0001 € за запрос с предоплаченного баланса или бесплатно на ключе Unlimited (50 € в месяц). Цены. Совместимые хосты отвечают на обратные запросы в форматах Google, Nominatim, Mapbox и других провайдеров.