My Geocode

Миграция

Переход с TomTom Search

· 3 мин чтения · My Geocode · #tomtom#миграция#геокодирование#автомобили#совместимость

TomTom Search широко используется в автомобильном ПО, системах управления автопарком и навигации, то есть в отраслях, где точность геокодирования вдоль маршрута важна не меньше, чем простое сопоставление адресов. Его API-ключ передаётся как параметр запроса, а ответы геокодирования приходят в виде массива results с объектом position и блоком address, содержащим поля вроде freeformAddress и municipality.

ПО в этой сфере часто создают команды, которые выбрали TomTom не с лёгкостью: обычно решение уже сопровождалось сравнением с альтернативами, поэтому последующая миграция, как правило, вызвана затратами, планированием резервирования или более широкой консолидацией поставщиков, а не недовольством самими данными. Этот контекст важен для того, как определяются рамки миграции: она редко бывает срочной, и обычно есть время как следует всё протестировать.

Совместимый хост My Geocode для TomTom воспроизводит массив results, объект position и поля адреса в точности так, как их возвращает TomTom, и единственное отличие составляют тексты об авторских правах, условиях и конфиденциальности. Справочник по полям описан по адресу /compatibility/tomtom/. Код, построенный вокруг results[0].position.lat и results[0].address.freeformAddress, должен продолжить работать после смены хоста и ключа.

Для ПО автопарков и автомобильной отрасли перед запуском переключения стоит перепроверить несколько вещей:

  • Все задания пакетного геокодирования, выполняемые по расписанию, поскольку это хорошая первая цель для тестирования нового хоста без затрагивания вызовов, которые в реальном времени обслуживают клиентов
  • Логику повторных попыток и тайм-аутов, настроенную под конкретное время ответа TomTom, поскольку эти значения часто подбираются опытным путём, а не документируются, и их может понадобиться настроить заново
  • Любой код, который читает специфичные для TomTom поля уверенности или качества совпадения; их стоит сравнить бок о бок с документированными эквивалентами совместимого хоста

Аутентификация поддерживает заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth или параметр запроса, что охватывает любой способ, которым ваш текущий клиент TomTom сейчас передаёт ключ.

По затратам такая структура убирает привычный этап корпоративных переговоров: 2 500 запросов в день бесплатны без ключа, и каждый ключ добавляет собственные 2 500 бесплатных запросов в день с учётом по сети. Сверх этой квоты действует предоплаченный баланс по 0,0001 € за запрос или ключ Unlimited за 50 € в месяц, и каждый эндпоинт, включая этот совместимый хост, стоит одинаково. Для автопарка, выполняющего геокодирование в заметных объёмах, одна фиксированная ставка вместо многоуровневого корпоративного соглашения значительно упрощает прогнозирование затрат.

Если помимо геокодирования вы используете в TomTom данные о маршрутах или трафике, эта часть стека выходит за рамки миграции только геокодирования и может остаться на TomTom, пока вызовы поиска адресов переносятся независимо. Разделение миграции по чётким границам функций, как здесь, обычно снижает риск сильнее, чем попытка перенести всё в одном релизе.

Ещё в разделе «Миграция»