今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
TomTom Searchとの互換ホストが利用可能に
ナビゲーションや物流のソフトウェアでは、TomTom Searchがかなり深いレベルで組み込まれていることがよくあります。そこでは位置検索が、同じチームが同じスタイルで作ったルーティングや地図の呼び出しと隣り合っていることが多いからです。他の部分に手を付けずに1つの部分だけを移行すること、それこそが私たちの互換ホストが可能にしようとしていることです。
このホストはTomTom Searchのリクエストパラメータとレスポンス本文を正確に再現しており、唯一の違いは著作権、規約、プライバシーに関する文言で、これは元のプロバイダーではなくMy Geocodeの内容になっています。コードが現在TomTom形式のジオコーディングリクエストを送っている場所ではどこでも、同じリクエストを私たちのホストに送ることができ、既存のロジックを一切変えずにレスポンスを同じように解析できます。
同じチームが作ったルーティングや地図の呼び出しは、慣習を共有していることが多いものです。同じリトライのロジック、同じエラー処理、タイミングに関する同じ前提です。似ているが異なるジオコーディングAPIを提供するのではなく、TomTom Searchのリクエストとレスポンスの形に正確に合わせることで、途中にある1つの呼び出しの向き先が変わっただけで、その周りのロジックを再テストする必要がなくなります。
認証には、いつもの4つの方法を使えます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。現在のTomTomとの連携がすでに使っている方法は、ここでも変更なしでそのまま受け付けられます。
料金は、プラットフォームの他のすべてのホストやエンドポイントと同じです。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあり、ネットワーク単位で数えられます。キーごとに、さらに1日あたり2,500件の無料リクエストが追加されます。両方の割り当てを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50で利用をカバーでき、ネイティブのエンドポイントではなく互換ホストを使うことによる追加料金はありません。
ナビゲーションや物流のソフトウェアを運用するチームは、環境ごとや社内サービスごとに1つずつなど、トラフィックを複数のキーに分けることがよくあります。そうすれば、ステージング環境で問題が起きても本番の割り当てが削られることはありません。ダッシュボードの/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形式の連携をここに向け直すのに必要なのは、ホスト名の変更と新しいキーだけで、それ以外は何もいりません。