My Geocode

Миграция

Отказ от интеграции с часовыми поясами Bing Maps

· 2 мин чтения · My Geocode · #bing-maps#часовой-пояс#миграция#api

К функциям часовых поясов Bing обычно обращаются либо через Locations API с флагом часового пояса, либо через отдельный вызов часового пояса, в зависимости от того, как изначально была построена интеграция. В любом случае они обычно находятся в том же аккаунте Bing Maps Dev Center, что и геокодирование, а значит, полный переход аккаунта обычно затрагивает и то, и другое сразу, даже если на самом деле речь идёт только о часовых поясах.

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

Определение часового пояса в My Geocode работает как независимый полноценный эндпоинт, описанный по адресу /docs/timezone-lookup/, полностью отдельно от совместимых хостов геокодирования. Он сразу возвращает сведения о часовом поясе для координаты, а значит, эта миграция не требует сначала принимать какие-либо решения об остальной интеграции с Bing Maps. Команды могут перенести вызовы часового пояса сейчас и не спеша оценить, стоит ли переносить и геокодирование.

Шаги, которым стоит следовать именно при этой миграции:

  1. Найдите все функции, которые сейчас вызывают функции часовых поясов Bing, учитывая, что в существующем коде они могут быть встроены в более широкий вызов Locations API, а не быть отдельным эндпоинтом
  2. Вынесите эту логику в отдельную функцию с понятным названием, если она ещё не выделена, чтобы сама замена провайдера стала одним локальным изменением
  3. Протестируйте новый эндпоинт на координатах с заведомо необычным поведением часовых поясов (регионы со смещением не на целое число часов, места без перехода на летнее время), прежде чем считать миграцию проверенной

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

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

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