今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
OpenStreetMap Nominatimとの互換ホストが利用可能に
NominatimはOpenStreetMapのデータで動いており、商用ライセンスの付かないジオコーディングの選択肢を求めるチームにとって、長い間定番の選択でした。しかし共有の公開インスタンスの利用ポリシーにより、トラフィックが増えるにつれてその仕組みに頼りにくくなることがあります。そこで役立つのが、割り当てを把握できる互換ホストです。
私たちのNominatim互換ホストは、元のサービスのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これはMy Geocode独自のものです。Nominatimの形式で組み立てたリクエストは変更せずに私たちのホストに送ることができ、レスポンスは既存の解析コードが想定しているのと同じ形で返されます。
ここでも認証はいつもの4つの方法に従います。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。Nominatimの公開インスタンスは通常キーをまったく必要としないため、ここでキーを使うと、管理されていない公開リソースを共有する代わりに、専用で追跡可能な割り当てが得られることにもなります。
料金は、私たちが運営する他のすべてのホストやエンドポイントと同じです。どのアドレスにも、キーなしで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がすべて含まれるので、公開されていない利用ポリシーを推測するのではなく、自分の状況を常に正確に把握できます。
互換レスポンスが既定で返す以上のものが欲しいプロジェクトでは、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、オプションの追加フィールドがその上に加わります。要求しない限り、基本の形は変わりません。
特定の国や地域で切り替えがどう動くか不安な方のために、/coverage/のカバレッジページでは、ジオコーディングデータがどこで利用できるかを詳しく説明しています。Nominatim形式かどうかにかかわらず、新しいホストに本番のトラフィックを向ける前に、まず確認するとよいページです。
このホストのドキュメントは/compatibility/nominatim/にあり、プロバイダーの切り替えに関する一般的な手引きは/docs/compatibility/にあります。現在Nominatimの公開インスタンスに頼っている方にとって、同じリクエストの形のまま、専用の割り当てとわかりやすい割り当てのヘッダーが得られます。