Mapbox Geocoding API — это веб-служба для преобразования между текстовыми адресами и географическими координатами, предоставляемая компанией Mapbox. API поддерживает прямое геокодирование (поиск по адресу или названию места), обратное геокодирование (получение человеко-читаемого адреса по координатам), автозаполнение запросов и дополнительные параметры фильтрации результатов. Интерфейс реализован по модели REST и возвращает структурированные ответы в формате JSON, содержащие сведения о найденных объектах, их типах, границах и точках привязки.
Исторически Geocoding API развивался как часть набора картографических сервисов Mapbox, ориентированных на разработчиков мобильных и веб-приложений. Функциональность сервиса включает поддержку различных языков и форматов ввода, возможности по ранжированию и уточнению результатов с учётом региональных предпочтений и контекста запроса. API используется в навигации, приложениях для поиска мест, в аналитике местоположения и при автоматическом заполнении форм адресов.
- Прямое геокодирование: поиск мест и адресов по текстовым запросам с возвратом координат, типов объекта и иерархии адреса.
- Обратное геокодирование: преобразование координат в человеко-читаемые адреса и ближайшие ориентиры.
- Автозаполнение (forward geocoding / autocomplete): по мере ввода текста возвращает предложенные варианты для ускорения ввода адреса.
- Поддержка типов объектов: классификация результатов по категориям (адрес, место, регион, почтовый индекс и др.).
- Параметры фильтрации: ограничение по стране, региону или типу места для сужения выдачи.
- Ранжирование и приоритеты: учёт местного приоритета, языковых предпочтений и радиуса релевантности для точного подбора результатов.
- Пакетные запросы: возможность отправки множества геокодинговых запросов в одной операции (batch), где это поддерживается.
- Метаинформация в ответе: возвращает состоящую из идентификаторов, точек привязки, ограничивающих рамок (bbox) и тегов, полезных для визуализации и дальнейшей обработки.
- Формат и интеграция: RESTful-интерфейс с ответами в JSON, совместимый с веб- и мобильными SDK для упрощения интеграции в приложения.
- Ограничения и учёт использования: сервис обычно предполагает аутентификацию ключом и применяет квоты и тарифы в зависимости от объёма запросов и условий использования.