POST AI agent ready /v1/geo/geocode

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

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

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Преобразуйте введенные пользователем адреса в метки в вашем приложении.

Когда пользователь вводит адрес в форму, геокодируйте его и размещайте маркер на карте. Во многих случаях это заменяет необходимость в платном API геокодирования Google Maps.

Дополните записи CRM или базы данных координатами

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

Frequently asked questions

Какой поставщик геокодирования поддерживает эту конечную точку?

Номинация OpenStreetMap. Результаты отражают качество данных OpenStreetMap, которое является высоким в большинстве стран, но может быть менее подробным в сельских или развивающихся регионах.

Поддерживает ли эта конечная точка адреса, отличные от английских?

Да. Nominatim поддерживает адреса на большинстве языков и алфавитов. Вы можете отправлять адреса на японском, арабском, кириллице или на любом языке, поддерживаемом OpenStreetMap.

Что произойдет, если адрес неоднозначен или не найден?

Если результаты не совпадают, API возвращает ошибку 404 NOT_FOUND. Для неоднозначных адресов API возвращает верхнее совпадение. Для большей точности указывайте как можно конкретнее (укажите город, штат, страну).

Существует ли ограничение скорости запросов геокодирования?

Анонимный доступ допускает 5 запросов в минуту. При использовании ключа API ограничение скорости определяется вашим планом. Сам Nominatim имеет политику 1 запрос в секунду, которую соблюдает эта конечная точка.

Могу ли я геокодировать IP-адреса с помощью этой конечной точки?

Нет. Эта конечная точка преобразует уличные адреса в координаты. Для геолокации IP используйте конечную точку /v1/ip/lookup.

Get your API key

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