今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
公開の互換性マトリックス:17のホスト、1つのキー
17もの互換ホストを、発表のたびに1つずつ追いかけるのは大変です。そこで、すべてを1か所にまとめました。/compatibility/にある互換性マトリックスでは、対応しているすべての互換ホストが並べて一覧表示され、それぞれのドキュメントへの直接リンクが付いています。
一覧に含まれるのは、Google Maps Platform、Bing Maps REST Services、HERE Geocoding and Search、Mapbox Geocoding、Geocode.Farm、OpenStreetMap Nominatim、OpenCage、LocationIQ、Geoapify、TomTom Search、MapQuest Geocoding、Geocodio、PositionStack、ip-api.com、ipinfo.io、ipstack、Open-Elevationです。これらでジオコーディング、IPジオロケーション、標高の検索をカバーしており、著作権、利用規約、プライバシーに関する文言(これは当社のものです)を除き、元の各プロバイダーのリクエストとレスポンスの形式を正確に再現しています。
1つのページにまとめた目的は、単に整理するためだけではありません。どのプロバイダーから移行するかを検討しているチームが、個別の発表を通じて互換ホストを1つずつ知るのではなく、全体を一度に見渡せるようにするためです。お使いのスタックがこれらのプロバイダーの複数に関わっている場合、たとえばジオコーディングにMapbox、IP検索にipinfo.ioを使っている場合や、その他のどのような組み合わせであっても、マトリックスを見れば、それらすべてを1つのMy Geocodeアカウントと1つのキーにまとめられることが分かります。
この集約こそが、互換性というアプローチ全般の本当の利点です。1つのキーで一覧のすべてのホストに対して認証でき、その方法も、X-API-Keyヘッダー、Authorization: Bearerヘッダー、HTTP Basic認証、クエリパラメーターという4つの標準的な方法のうち、お使いの連携がすでに採用しているものを使えます。すべてのホストでの使用量は、同じ無料割り当て、同じプリペイドクレジット残高、または同じUnlimitedパッケージに対してカウントされ、どのホストが返したレスポンスにも同じ割り当てヘッダーが付きます。1つのアカウント、1つのキー、1つの請求で、これまで連携が依存していた複数のプロバイダーを何社分でもカバーできます。
1つのプロバイダーを置き換えるのではなく、より広範な移行を検討しているチームにとって、このマトリックスは自然な出発点となります。移行に関する全般的なガイダンスは、その隣の/docs/compatibility/にあります。各ホストのドキュメントページでは、具体的なリクエストパラメーターと、切り替え前に知っておくべき詳細を説明しています。
互換性の対応範囲の変化に合わせてこのページを最新の状態に保っていく予定です。個々の発表の合間に古くなってしまうものではなく、利用できるものを確認するための唯一のリファレンスであり続けるようにします。