В навигационное и логистическое ПО TomTom Search часто встроен довольно глубоко, поскольку поиск местоположений там обычно соседствует с вызовами маршрутизации и картографии, написанными той же командой и в том же стиле. Перенести одну часть, не трогая остальное, как раз и позволяет наш совместимый хост.
Он в точности воспроизводит параметры запросов и тело ответа TomTom Search, и единственное отличие составляет текст об авторских правах, условиях и конфиденциальности, который относится к My Geocode, а не к исходному провайдеру. Где бы ваш код сегодня ни отправлял запрос геокодирования в формате TomTom, он может отправить тот же запрос на наш хост, и ответ будет разбираться так же, без каких-либо изменений в вашей существующей логике.
Вызовы маршрутизации и картографии, написанные одной командой, обычно следуют общим соглашениям: одна и та же логика повторных попыток, одна и та же обработка ошибок, одни и те же ожидания по времени ответа. Точное воспроизведение структуры запросов и ответов TomTom Search, а не похожий, но другой API геокодирования, означает, что окружающую логику не нужно заново тестировать только потому, что один вызов посередине теперь направлен в другое место.
Аутентификация использует наши обычные четыре варианта: заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth с ключом в качестве имени пользователя или параметр запроса. Какой бы способ ни использовала ваша текущая интеграция с TomTom, здесь он тоже принимается без изменений.
Цены идентичны всем остальным хостам и эндпоинтам платформы. Любой адрес получает 2 500 бесплатных запросов в день без всякого ключа, с подсчётом по сети. Ключ добавляет ещё свои 2 500 бесплатных запросов в день. Сверх обеих квот предоплаченный баланс стоит 0,0001 € за запрос, или пакет Unlimited покрывает использование за 50 € в месяц, без доплаты за использование совместимого хоста вместо собственного.
Команды, работающие с навигационным или логистическим ПО, часто распределяют трафик между несколькими ключами, по одному на каждое окружение или на каждый внутренний сервис, чтобы проблема на тестовом стенде никогда не съедала квоту рабочей среды. Страница ключей в личном кабинете, /dashboard/keys, позволяет создавать и называть дополнительные ключи для интеграции в формате TomTom точно так же, как для любой другой.
Заголовки квот прикрепляются к каждому ответу и на этом хосте: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used и X-Credits-Remaining присутствуют все, давая такое понимание использования, которое прямая интеграция с TomTom иначе не показала бы.
Если проекту нужно больше, чем стандартный совместимый ответ, добавление mg_extras=1 к запросу или отправка заголовка X-MG-Extras накладывает поверх необязательные дополнительные поля, исключительно по вашему выбору, оставляя базовую структуру ответа нетронутой, пока вы специально не попросите большего.
Хост описан на /compatibility/tomtom/, а общие рекомендации по миграции для совместимых хостов платформы находятся на /docs/compatibility/. Чтобы перенаправить сюда существующую интеграцию в формате TomTom, нужно изменить имя хоста и взять новый ключ, и больше ничего.