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

API пакетного геокодирования — бесплатная массовая адресация координат

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

Parameters

arrayrequired

Array of address strings to geocode (max 10).

Code examples

curl -X POST https://api.botoi.com/v1/geo/batch \
  -H "Content-Type: application/json" \
  -d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'

When to use this API

Нанесение местоположения клиентов на карту

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

Обогатите импорт CSV координатами

Обрабатывать загруженные файлы CSV, содержащие адреса. Пакетно геокодируйте столбец адреса и добавляйте широту и долготу к каждой строке перед сохранением в базе данных.

Проверка нескольких адресов при отправке формы

Когда пользователь отправляет форму с несколькими адресами (например, выставление счетов + доставка + альтернативный), геокодируйте все адреса за один вызов API. Отметьте все, что не удалось решить, прежде чем принять отправку.

Frequently asked questions

Какое максимальное количество адресов в одном запросе?
Вы можете отправить до 10 адресов за один запрос. Для больших пакетов разделите список на части по 10 и отправьте несколько запросов.
Что произойдет, если один адрес выйдет из строя?
Неудачные адреса возвращают lat: null, lng: null и сообщение об ошибке. Остальные пакеты обрабатываются нормально. Проверьте количество неудачных попыток в ответе, чтобы определить проблемные адреса.
Вызовы геокодирования выполняются параллельно?
Да. Все адреса в пакете геокодируются одновременно для сокращения времени ответа. Пакет из 10 адресов занимает примерно то же время, что и один запрос геокодирования.
Могу ли я геокодировать более 10 адресов?
Не в одном запросе. Разделите свой список на группы по 10 и отправьте несколько запросов. С платным планом вы можете отправлять несколько пакетных запросов в секунду.
Это тот же геокодер, что и /v1/geo/geocode?
Да. Конечная точка пакета использует тот же геокодер OpenStreetMap Nominatim, что и конечная точка с одним адресом. Результаты идентичны для одного и того же ввода.

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