今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
MapQuest Geocodingとの互換ホストが利用可能に
MapQuest Geocodingは多くの長期運用のアプリケーションに組み込まれており、その中には、問題なく動き続けているという理由で位置検索のコードに何年も手を付けていないものもあります。私たちの互換ホストは、まさにそうした状況のために作られています。問題なく動いていて誰も書き直したくないコードでも、チームとしては作り直さずに古くなった連携から移行したい、という状況です。
このホストはMapQuestのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは元のプロバイダーではなく私たちのものです。現在MapQuestのジオコーディングエンドポイント向けの形になっているリクエストはそのまま私たちのホストに送ることができ、返されるレスポンスは既存のコードが想定しているのと同じように解析できます。
必要な変更はホスト名とキーだけです。キーは、私たちの4つの標準の方法のうち、現在の連携に合うもので認証できます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。
キーを取得するのに、先にアカウントの確認を済ませる必要はありません。新しく登録したアカウントのキーは、My Geocodeが登録メールアドレスの確認を求めるまでの猶予期間中も動作し、その後、未確認のキーは完全に失敗するのではなく一時停止します。これはまさにこうした移行テストで重要になります。金曜日の午後に、メールのやり取りを待たずに古い連携を新しいホストに向けてみたい、という場面です。
料金は、My Geocodeの他のすべての場所と同じ仕組みに従います。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあり、ネットワーク単位で数えられます。キーごとに、それとは別に1日あたり2,500件の無料リクエストが追加されます。これらの割り当てを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50で利用をカバーでき、このホストと他のホストで料金の違いはありません。
すべてのレスポンスには、プラットフォームの他の部分と同じ割り当てのヘッダーが付きます。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit、X-Quota-Resetです。このうちX-Key-IPs-UsedとX-Key-IPs-Limitの2つは、ネットワークではなくキーに固有のものを追跡します。各キーには、呼び出し元として使えるIPアドレスの数が少数、ローリング方式で割り当てられています。これにより、キーが無関係な多数のサーバーで共有されるのを防ぎつつ、アプリケーションの送信元アドレスが変わる通常のデプロイには対応できます。
互換レスポンスが返す以上のものが欲しいプロジェクトでは、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、標準の形の上にオプションのフィールドが加わります。これは完全にオプトインです。
このホストのドキュメントは/compatibility/mapquest/にあり、プラットフォーム全体の互換性の概要は/docs/compatibility/にあります。MapQuest Geocodingがまだスタックの中で静かに動いているなら、見慣れた同じ形の裏で現代的な割り当ての仕組みがどう見えるかを低コストで確かめられます。