Значительная часть кода, написанного под Mapbox Geocoding, находится внутри фронтенд-приложений, мобильных приложений и внутренних инструментов, где сам вызов геокодирования представляет собой небольшую, легко упускаемую из виду деталь, скрытую в более крупной системе. Смена провайдера там обычно означает, что сначала нужно найти все места, где живёт эта деталь, и только потом можно что-то делать. Наш совместимый хост призван сократить эту работу почти до нуля.
Он в точности воспроизводит формат запросов и структуру ответов Mapbox, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит My Geocode. Где бы ваш код сейчас ни отправлял запрос в формате Mapbox, он может отправить тот же запрос на наш хост, и возвращаемый ответ будет разбираться так же, как уже ожидает ваш существующий код.
Аутентификация тоже следует нашей обычной схеме и не заставляет переписывать и эту часть. Передайте ключ в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в параметре запроса, в зависимости от того, как сейчас проходит аутентификацию ваш клиент. Все четыре способа работают на каждом нашем хосте и эндпоинте.
Цены не меняются в зависимости от того, какой хост обработал запрос. Любой адрес получает 2 500 бесплатных запросов в день без всякого ключа, с подсчётом по сети, а не по отдельному клиенту. Ключ добавляет ещё свои 2 500 бесплатных запросов в день. Сверх обеих квот предоплаченный баланс стоит 0,0001 € за запрос, или пакет Unlimited покрывает всё за 50 € в месяц. Совместимый хост стоит ровно столько же, сколько наши собственные эндпоинты /v1/forward и /v1/reverse.
Заголовки квот прикрепляются к каждому ответу независимо от формата и дают прозрачность, которой обычная интеграция с Mapbox сама по себе не обеспечивает: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit и X-Quota-Reset присутствуют на этом хосте так же, как и везде.
Для всего, что выходит за рамки совместимой структуры ответа, mg_extras=1 в запросе или заголовок X-MG-Extras добавляет поверх необязательные дополнительные поля, не меняя базовую структуру. По умолчанию это выключено, поэтому ответ соответствует структуре Mapbox, пока вы явно не попросите большего.
Хост находится на /compatibility/mapbox/, а общие рекомендации по переносу интеграции на /docs/compatibility/. Если вы сегодня поддерживаете интеграцию в формате Mapbox, проверка обойдётся в один ключ и один изменённый базовый URL.