今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
OpenCageとの互換ホストが利用可能に
OpenCageは、余計なものがあまり付いていない、わかりやすくドキュメントの充実したジオコーディングAPIを好む開発者の間で支持を集めてきました。私たちも同じ考え方で互換ホストを作りました。リクエストとレスポンスの形式を正確に合わせ、切り替えがやり直しのように感じられないようにしています。
このホストはOpenCageのリクエストパラメータとレスポンス本文を正確に再現しており、違いは著作権、規約、プライバシーに関する文言だけです。これはMy Geocode独自のものです。現在OpenCage形式のリクエストを組み立て、OpenCage形式のレスポンスを解析しているコードは、その2つの部分にまったく手を加えずに私たちのホストに向けられます。
変わるのは、設定にあるホスト名と、認証に使うキーです。キーはX-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータとして送ることができ、既存のクライアントライブラリがすでに採用している方法に合わせられます。4つとも、私たちが運営するすべてのホストで同じように動作します。
料金は、どのホストがリクエストを処理するかに関係なく、私たちの標準の仕組みに従います。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあり、ネットワーク単位で数えられます。さらにキーごとに1日あたり2,500件の無料リクエストが追加されます。両方の割り当てを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50で利用をカバーでき、呼び出しがこの互換ホストを通ったか/v1/forwardに直接送られたかによって、これらが変わることはありません。
すべてのレスポンスに割り当てのヘッダーが付き、OpenCageとの素の連携では得られない利用状況の可視性が加わります。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ヘッダーを送ると、地表の標高などのオプションのフィールドがその上に加わります。要求しない限り、基本の形は崩れません。
このホストのドキュメントは/compatibility/opencage/にあり、プラットフォーム全体で互換ホストがどう機能するかの概要は/docs/compatibility/にあります。OpenCageがすでにスタックに組み込まれているなら、試すのに必要なのはベースURLの変更1か所と新しいキーだけです。