Перейти к содержимому
POST AI agent ready /v1/geo/reverse

API обратного геокодирования — преобразование широты и долготы в адрес

Отправьте пару широты и долготы и получите соответствующий почтовый адрес, город, страну и отображаемое имя. Работает на базе сервиса OpenStreetMap Nominatim. Полезно для преобразования координат GPS с устройств, данных EXIF ​​фотографий или щелчков по карте в читаемые местоположения.

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

Отображать читаемый адрес, когда пользователи прикрепляют булавку к карте.

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

Отмечайте фотографии названиями мест из данных EXIF ​​GPS.

Извлеките широту и долготу из метаданных EXIF ​​фотографий и выполните обратное геокодирование. Отобразите «Снято в Маунтин-Вью, Калифорния» вместо необработанных координат в вашей фотогалерее.

Дополните данные отслеживания автопарка уличными адресами

Преобразуйте координаты GPS с трекеров транспортных средств в почтовые адреса для журналов отправки, подтверждений доставки и отчетов о маршрутах.

Frequently asked questions

Какие данные содержит ответ?
Ответ включает полное отображаемое имя (уличный адрес), более короткое поле адреса, город, страну и исходную широту/долготу. Уровень детализации зависит от покрытия OpenStreetMap данного местоположения.
Что произойдет, если координаты находятся в океане или не нанесенной на карту области?
API возвращает ошибку 404 NOT_FOUND, если Nominatim не может найти адрес по заданным координатам. Открытый океан, отдаленная дикая местность и Антарктида могут не иметь адресных данных.
Насколько точны результаты?
Точность зависит от плотности данных OpenStreetMap для данной области. В городах вы обычно получаете точность на уровне здания. В сельской местности результаты могут относиться к ближайшей дороге или деревне.
Могу ли я выполнить обратное геокодирование нескольких координат в одном запросе?
Нет. Каждый запрос обрабатывает одну пару координат. Для пакетной обработки делайте параллельные запросы. Соблюдайте ограничение скорости Nominatim в 1 запрос в секунду для анонимного доступа.
Эта конечная точка бесплатна?
Да. Анонимный доступ допускает 5 запросов в минуту. Ключ API повышает лимит скорости в зависимости от уровня вашего плана. Плата за каждый запрос не взимается.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs