今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
PositionStackとの互換ホストが利用可能に
PositionStackは比較的軽い連携で使われることが多く、大きなアプリケーションの中で1つのAPI呼び出しを包むサービスクラス1つ程度ということがよくあります。こうした連携は、見落としやすいほど小さく、それでいて書き直すのが面倒な程度には大きいものです。私たちの互換ホストは、その書き直しを完全になくすことを目指しています。
このホストはPositionStackのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは元のプロバイダーではなく私たちのものです。PositionStackのジオコーディングエンドポイント向けに組み立てたリクエストは変更せずに私たちのホストに送ることができ、レスポンスは既存のコードが解析しているのと同じ形で返ってきます。
変わるのはホスト名とキーです。キーは、私たちの4つの標準の方法のうち、連携がすでに使っているもので認証できます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。
1つの呼び出しを包むサービスクラス1つという連携は、誰もドキュメントを残さない種類のものでもあるため、疑問は後からそのコードを引き継いだ人からのサポートチケットとして表面化しがちです。My Geocodeのサポート窓口では、ヘッダーの意味、キーの形式、何が変わり何が変わらないかといった、こうした繰り返し寄せられる互換性の質問に対する定型の回答を用意しています。そのため、単純な移行の質問は、より込み入った質問の後ろで待たされることなく、すばやく回答されます。
コードに手を付ける前にレスポンスの形を確かめるのも簡単です。/demo/のインタラクティブなデモでは、任意のエンドポイントや互換ホストにサンプルのリクエストを送り、返ってくるフィールドを正確に確認できます。PositionStack形式の呼び出しが後段の処理で問題なく解析されることを確かめるには、多くの場合これで十分です。
料金は、どの互換ホストがリクエストを処理したかによって変わりません。どのアドレスにも、キーなしで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で、PositionStackとの素の連携では得られない利用状況の可視性を提供します。
互換レスポンスの標準フィールド以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、オプションの追加情報がその上に加わります。これは完全にオプトインで、既定ではオフです。
このホストのドキュメントは/compatibility/positionstack/にあり、17の互換ホストすべてがどう機能するかの概要は/docs/compatibility/にあります。PositionStackがスタック内のどこかのサービスに組み込まれているなら、ここに向けるのは、小さく元に戻せる変更として試せます。