今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
Google Maps Platformとの互換ホストが利用可能に
Google Maps Platformは、世界でもっとも広く組み込まれているジオコーディングサービスのひとつであり、それだけに乗り換えがもっとも難しいサービスのひとつでもあります。別のプロバイダーを試すためだけに、コードベース全体でリクエストの組み立て処理とレスポンスの解析処理を書き直すのは、かかる開発工数に見合うことはまずありません。そこで私たちは、何も書き直す必要のないホストを作りました。
私たちのGoogle Maps Platform互換ホストは、元のサービスのリクエストパラメータとレスポンス構造を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは私たちのものです。現在の連携がGoogleのジオコーディングエンドポイントに送っているものは何であれ、代わりに私たちのエンドポイントに送れます。プロバイダーの切り替えは、開発プロジェクトではなく、ホスト名とキーを変えるだけの作業になります。
これは私たち独自のネイティブエンドポイントと並んで提供されます。新しく始める場合は、/v1/forward、/v1/reverse、/v1/autocomplete、/v1/postcodeが/docs/で説明されており、私たちのリクエストの形をそのまま使えます。すでにGoogleの形式で書かれたコードがある場合は、/compatibility/google-maps/の互換ホストを使えば、そのコードをそのまま使い続けられます。
認証は、My Geocode全体と同じ柔軟な方法で行えます。キーをX-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータとして送ってください。既存のクライアントライブラリがGoogleのAPIに対してどの方式を使っていても、この4つのうちどれかが一致するので、連携の認証コードを変える必要もほとんどありません。
互換ホストの料金は、My Geocodeの他のすべての場所と同じです。どのアドレスからでもキーなしで1日あたり2,500件をネットワーク単位で利用でき、それに加えてキーごとに1日あたり2,500件の無料リクエストがあります。それを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50ですべてをカバーできます。ネイティブエンドポイントではなく互換ホストを使うことで、別の高い料金がかかることはありません。すべてのエンドポイントとすべての互換ホストの料金は同じです。
すべてのレスポンスには、APIの他の部分と同じ割り当てのヘッダーも付きます。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Credits-Remainingなどで、単にプロバイダーを入れ替えただけでは無料では得られない利用状況の可視性を提供します。
連携に標準のレスポンス以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、地表の標高などのオプションの追加フィールドが互換の形の上に加わります。これは純粋な追加です。付けなければ、レスポンスは元のプロバイダーの形式と正確に一致します。
試すのにかかるのはスプリント1回分ではなく数分です。新しいキーでテスト呼び出しを/compatibility/google-maps/に向け、現在得ているレスポンスと比較してみてください。