今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
Mapbox Geocodingとの互換ホストが利用可能に
Mapbox Geocodingを対象に書かれたコードの多くは、フロントエンドのアプリケーション、モバイルアプリ、社内ツールの中にあり、ジオコーディングの呼び出し自体は大きなシステムに埋もれた、見落としやすい小さな部分です。そこでプロバイダーを変えるには、たいてい何よりも先に、その部分が存在するすべての場所を見つけ出す必要があります。私たちの互換ホストは、その作業をほぼゼロにまで減らすためのものです。
このホストはMapboxのリクエスト形式とレスポンス構造を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これはMy Geocode独自のものです。コードが現在Mapbox向けの形でリクエストを送っている場所ではどこでも、同じリクエストを代わりに私たちのホストに送ることができ、返ってくるレスポンスは既存のコードが想定しているのと同じように解析できます。
認証も、その部分の書き直しを強いることなく、いつものパターンに従います。キーをX-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータとして、現在のクライアントの認証方法に合うもので送ってください。4つとも、私たちが運営するすべてのホストとすべてのエンドポイントで動作します。
料金は、どのホストがリクエストを処理したかによって変わりません。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあり、個々の呼び出し元ではなくネットワーク単位で数えられます。キーごとに、さらに1日あたり2,500件の無料リクエストが追加されます。両方の割り当てを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50ですべてをカバーできます。互換ホストの料金は、私たちのネイティブの/v1/forwardと/v1/reverseエンドポイントとまったく同じです。
形式にかかわらず、すべてのレスポンスに割り当てのヘッダーが付き、Mapboxとの素の連携だけでは得られない可視性を提供します。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit、X-Quota-Resetは、このホストでも他のすべての場所と同じように返されます。
互換レスポンスの形を超えるものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、基本の構造を変えずにオプションの追加フィールドがその上に加わります。既定ではオフなので、明示的に追加を要求するまで、レスポンスはMapboxの形と一致します。
このホストは/compatibility/mapbox/にあり、連携を移行するための一般的な手引きは/docs/compatibility/にあります。現在Mapbox形式の連携を保守しているなら、試すのに必要なのはキー1つとベースURLの変更1か所だけです。