今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
Geocode.Farmとの互換ホストが利用可能に
Geocode.Farmは長い間、数多くの小規模なアプリケーションや社内ツールで目立たずにジオコーディングを支えてきました。多くの場合、初期の開発時に組み込まれ、それ以来そのままになっています。私たちの互換ホストはまさにこうした連携のためのものです。問題なく動き続けてきた連携には、書き直しではなく簡単な移行の道が用意されるべきです。
このホストはGeocode.Farmのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これはMy Geocode独自のものです。現在Geocode.Farmのエンドポイント向けの形になっているリクエストは、そのまま私たちのホストに向けることができ、レスポンスは既存のコードが想定しているのと同じ構造で返されます。
切り替えに必要なのはホスト名とキーの変更だけで、その周りのリクエストやレスポンスの解析ロジックは一切変える必要がありません。キーはX-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータで認証でき、現在の連携がすでに送っている方法に合わせられます。
このような古い連携は、プロバイダーのSDKが存在する前や、採用する価値が出る前に、生のHTTP呼び出しで直接書かれていることがよくあります。My Geocodeは独自のSDKを公開しており、/sdks/に一覧があります。コードのこの部分に手を入れるついでに生のHTTPから完全に移行したい方向けですが、互換ホストを使うためにそれが必要なわけではありません。
料金はプラットフォームの他の部分と同じルールに従います。どのアドレスにも、キーなしで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、X-Key-IPs-Used、X-Key-IPs-Limit、X-Quota-Resetです。小規模で古い連携では、これまで得られなかったかもしれない利用状況の可視性を提供します。
互換レスポンスが返す以上のものが欲しいプロジェクトでは、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、オプションの追加フィールドがその上に加わります。これは完全にオプトインで、既定ではオフです。
これで、私たちが公開している互換ホストは合計17になり、ジオコーディング、IPジオロケーション、標高にまたがっています。この数に達したのは、考えられるすべてのプロバイダーを網羅するためというより、実際の連携が本当に使っているプロバイダーを網羅するためでした。だからこそ、一覧は1つのカテゴリーに偏らず、この3つのカテゴリーにまたがっているのです。
ホスト自体のドキュメントは/compatibility/geocode-farm/にあり、全一覧は/compatibility/にあります。Geocode.Farmがスタック内の古い連携の一部になっているなら、同じリクエストの形の裏で現代的な割り当ての仕組みがどう見えるかを手軽に確かめられます。