今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
Geoapifyとの互換ホストが利用可能に
Geoapifyはジオコーディングをより幅広い位置情報ツールと組み合わせて提供しているため、Geoapifyを対象に作られた連携は、API呼び出し1つから想像されるよりもコードベースの広い範囲に関わっていることがあります。私たちの互換ホストは、ジオコーディングのリクエストとレスポンスの形だけに絞って正確に合わせているので、その部分だけを周りに影響を与えずに移行できます。
このホストはGeoapifyのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは元のプロバイダーではなく私たちのものです。現在Geoapifyのジオコーディングエンドポイント向けに組み立てられているリクエストは、そのまま私たちのホストに送ることができ、返されるJSONは既存のコードが想定しているのと同じように解析できます。
このように範囲を絞っているのは意図的です。Geoapify自身のプラットフォームは、ジオコーディングに加えてルーティング、等時線、場所検索も扱っており、それらすべてを1つの互換ホストで再現しようとすると、リリースのスケジュールがジオコーディングとはかけ離れた機能に縛られてしまいます。ホストをジオコーディングのエンドポイントに限定することで、元のサービスとの照合が簡単になり、My Geocodeが独自の機能を追加していく中でも歩調を合わせやすくなります。
切り替えに必要なのは、ホスト名とキーを変えることだけです。キーは、私たちが運営するすべてのホストと同じ柔軟な方法で認証できます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。現在のクライアントがどれを送っていても、ここでも受け付けられます。
その下にある料金体系は、プラットフォームの他の部分と変わりません。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあり、ネットワーク単位で数えられます。さらにキーごとに1日あたり2,500件の無料リクエストが追加されます。両方の割り当てを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50ですべてをカバーできます。呼び出しがこのホストに送られても、/v1/forwardに直接送られても、同じ料金が適用されます。
ここでもすべてのレスポンスに割り当てのヘッダーが付きます。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がすべて返され、Geoapifyとの素の連携だけでは得られない可視性を提供します。
ジオコーディングの連携を新しいプロバイダーに移行するときは、アカウントのセキュリティ全般を見直すのにもちょうどよい機会です。ダッシュボードの二要素認証の設定はAPIキーや請求の設定のすぐ隣にあるので、新しいキーを持つことになったアカウントでこれを有効にするのは、別のプロジェクトではなく追加の1ステップで済みます。
標準の互換レスポンス以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、オプションのフィールドがその上に追加されます。明示的に要求しない限り、基本の形は変わりません。
このホストの完全なドキュメントは/compatibility/geoapify/にあり、17の互換ホストすべてを扱う互換性リファレンスは/docs/compatibility/にあります。すでにスタックの一部でGeoapifyを使っているなら、私たちのサービスと比較する手軽な方法です。