今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
Bing Maps REST Servicesとの互換ホストが利用可能に
多くの地図連携は何年も前にBing Maps REST Servicesを対象に作られ、それ以来手を加えられないまま動き続けています。書き直す強い理由がなかったからです。私たちは今、その理由がひとつできたと考えています。同じリクエストを受け付けて同じ形のレスポンスを返し、最初の呼び出しから料金と割り当ての仕組みが明確な互換ホストです。
私たちのBing Maps REST Services互換ホストは、元のサービスのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは元のプロバイダーではなくMy Geocodeの内容になっています。Bingの形式でリクエストを組み立てるコード、Bingの形式でレスポンスを解析するコード、またはその両方を行う既存のコードは、書き直しなしで私たちのホストに向けられます。
そのために変えるのは2つだけです。リクエストの送信先のホスト名と、認証に使うキーです。キーは、連携がすでに想定している送り方のどれでも送れます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、または通常のクエリパラメータです。この4つは、このホストを含むすべてのMy Geocodeホストでまったく同じように動作します。
互換レイヤーの下にある料金体系は、プラットフォームの他の部分とまったく同じです。すべてのアドレスには、キーがなくても1日あたり2,500件の無料リクエストがあります。これはネットワーク単位で数えられるため、共有の回線を多数のキーに分けて無料枠を増やすことはできません。さらに、キーごとに1日あたり2,500件の無料リクエストが追加されます。これらの割り当てを超えた分は、1リクエストあたり€0.0001のプリペイドクレジット、または月額€50のUnlimitedパッケージから差し引かれます。この料金は、リクエストがどのホストやエンドポイントに送られたかに関係なく変わりません。
レスポンスの形が別のプロバイダーと同じだからといって、割り当ての可視性がなくなるわけではありません。すべての呼び出しで、X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remainingをはじめとする標準のヘッダー一式が返されるため、特定のキーやネットワークの状況を常に正確に把握できます。これは元のサービスがこの形では提供していないものです。
厳密な互換レスポンス以上のものが欲しいチームは、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、標準の形を崩さずにその上へオプションのフィールドを追加できます。このフラグをまったく付けなければ、レスポンスは構造上、元のAPIが返したであろうものと区別がつきません。
既存の連携をエンドポイントごとに移行する手順を説明した移行ガイドは/docs/compatibility/にあり、ホスト自体のドキュメントは/compatibility/bing-maps/にあります。試すのに必要なのは、数分の空き時間とキーだけです。