ZapierやMakeの自動化を新しいジオコーディングホストへ移行する
ジオコーディングのステップを含むノーコードの自動化には、独自のコードとは異なる移行方法が必要です。その切り替えの進め方を紹介します。
Bing Maps REST Servicesからの移行
Bing Maps REST Servicesのレスポンス形式には見覚えのある特徴があります。最上位のオブジェクトに resourceSets 配列があり、その各要素に resources が含まれ、各リソースは point オブジェクトを持ち、座標は緯度と経度の別々のフィールドではなく coordinates 配列の中にネストされています。これに合わせて開発してきた開発者は、多くの場合Bing Mapsが自然な選択肢だった.NETの現場で、この構造を暗記しています。別の構造に合わせて書き直すのは、まさに移行を何か月もスケジュールから遠ざけてしまう、地味で退屈な作業です。
Bing Maps Dev Centerで生成したキーはクエリパラメータとして送信されます。これはほとんどのコンシューマー向け地図APIに共通するパターンです。連携のこの部分は、たいてい誰にとっても一番心配の少ないところです。本当の結合があるのはレスポンスの解析です。
My Geocodeは、このresourceSetsの構造をそのまま再現するBing Maps互換ホストを運用しているため、resourceSets[0].resources[0].point.coordinates を読み取る解析コードは、切り替え後もそのまま動作します。レスポンスの中でBingの元の形式と異なるのは、著作権表示、利用規約、プライバシーに関するテキストだけで、これは必然的に当社のものになります。詳細は/compatibility/bing-maps/にあります。
切り替える前に確認しておく価値のある点をいくつか挙げます。
- コードが信頼度やマッチコードのフィールドを読み取っているかどうかを確認します。これらはすばやく並べて比較する価値があります
- クライアントライブラリがどの認証方式を使っているかを確認します。キーは
X-API-Key、Authorization: Bearer、HTTPベーシック認証、クエリパラメータのいずれでも送信できるため、ライブラリがすでに使っている方式のままで動作するはずです - オプションの追加フィールド(標高、IPの脅威情報、ネットワーク詳細)を
mg_extras=1で有効にするかどうかを決めます。これらは標準の形式を置き換えるのではなく、その横に追加されます
それに比べると、商用面はわかりやすいものです。請求アカウントを設定する手順はありません。キーなしで1日2,500件のリクエストが無料で、各キーにはネットワーク単位でカウントされる独自の1日2,500件の無料リクエストがあります。その無料枠を超えた分は、1リクエストあたり€0.0001のプリペイドクレジットか、月額€50のUnlimitedキーです。互換ホストの料金は、プラットフォーム上の他のすべてのエンドポイントと同じです。
より大きな.NETアプリケーションやエンタープライズアプリケーションの一部としてジオコーディングを運用しているチームにとって、移行の範囲は通常、外から見えるよりも小さなものです。resourceSetsのラッパーは、コードベースのあちこちに散らばって直接読み取られるのではなく、よくまとまった少数のアクセサメソッドを通じて読み取られるのが普通だからです。まずそのアクセスポイントを見つけ、ステージング環境でそれらを新しいホストに向けることは、本番トラフィックに手を加える前に切り替えを検証する妥当な方法です。
連携がジオコーディングと並んでBingのタイムゾーンや標高のエンドポイントも呼び出している場合、それらは別に扱います。My Geocode独自のタイムゾーン検索と標高検索はジオコーディングの互換ホストとは独立して機能するため、同じコードパスに無理に通すのではなく、それぞれに合った形で接続する価値があります。すべてのリクエストに含まれる X-Quota-Limit などのレスポンスヘッダーを含む割り当ての詳細は、/docs/rate-limits/に記載されています。