移行

Bing Mapsのタイムゾーン連携から移行する

Bingのタイムゾーン機能には、連携が当初どのように構築されたかによって、タイムゾーンのフラグを付けたLocations APIを通じてアクセスするか、専用のタイムゾーンの呼び出しを通じてアクセスするのが一般的です。いずれにしても、ジオコーディングと同じBing Maps Dev Centerアカウントの中にあることが多いため、実際に問題になっているのがタイムゾーンの部分だけであっても、アカウント全体を切り替えると通常は両方に同時に影響します。

タイムゾーンのデータは、小さく範囲のはっきりしたレスポンスです。識別子、UTCオフセット、そして通常は指定した座標と日付における夏時間の実施状況に関する情報です。このコンパクトさは移行を計画するうえで本当に有利です。移行完了とする前に実際のテストケースで検証すべきレスポンス構造が比較的少ないからです。

My Geocodeのタイムゾーン検索は、ジオコーディング互換ホストとは完全に切り離された、独立して完全に動作するエンドポイントで、/docs/timezone-lookup/で説明しています。座標のタイムゾーン情報を直接返すため、この移行ではBing Maps連携の残りの部分について先に何かを決める必要はありません。チームはタイムゾーンの呼び出しを今すぐ移し、ジオコーディングも移行するかどうかは時間をかけて検討できます。

この移行で特に踏むべき手順です。

  1. 現在Bingのタイムゾーン機能を呼び出しているすべての関数を特定します。既存のコードでは、独立したエンドポイントではなく、より広いLocations APIの呼び出しの中に組み込まれている可能性がある点に注意してください
  2. まだ分離されていなければ、その処理をわかりやすい名前の独立した関数に切り出します。そうすれば、実際のプロバイダーの切り替えは1か所に限定された1つの変更になります
  3. 移行を検証済みとする前に、タイムゾーンの挙動が特殊であることがわかっている座標(1時間単位でないオフセットの地域や、夏時間のない場所)で新しいエンドポイントをテストします

認証にはキーを使い、X-API-KeyAuthorization: Bearer、HTTP Basic認証、クエリパラメータのうち、アプリケーションの他の部分がすでに他のサービスへ認証情報を送っている方法に最も合うもので送信します。

料金はすべて一律です。キーなしで1日あたり2,500リクエストが無料、さらにキーごとにネットワーク単位でカウントされる1日あたり2,500リクエストが無料で、その後は1リクエストあたり€0.0001のプリペイドクレジット、または月額€50のUnlimitedキーとなり、タイムゾーン検索とその他のエンドポイントとで別の料金が設定されることはありません。多くのアプリケーションでは、ジオコーディングの量に比べてタイムゾーンの呼び出しが実際にはごくわずかであることを考えると、全面的な移行の後でも、この部分が1日の無料枠に余裕で収まることはよくあります。有料プランが必要だと決めつける前に、自社の数値と照らし合わせて確認する価値があります。