今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
すべてのレスポンスに割り当てヘッダー：呼び出す前に上限を把握
多くのAPIでは、何かが壊れるまで自分の利用状況を推測するしかありません。My Geocodeは異なるアプローチをとっています。すべてのエンドポイントとすべての互換ホストの、ひとつひとつのレスポンスに、現在の状況を正確に示す割り当てヘッダー一式が付いています。
X-Quota-LimitとX-Quota-Usedは、呼び出し元のキーまたはネットワークの基本的な状況を示します。X-Quota-Free-Remainingは1日あたりの無料割り当ての残りを示し、X-Quota-Network-Usedは、ネットワーク単位で共有される無料割り当てのうち、同じ接続上のアドレスやキーによってすでに消費された量を反映します。X-Credits-Remainingは、無料枠を超えていてUnlimitedパッケージを利用していない場合のプリペイドクレジット残高を示します。X-Key-IPs-UsedとX-Key-IPs-Limitは、あるキーが使われた異なるアドレスの数を追跡し、X-Quota-Resetは1日のカウンターがリセットされる時刻を示します。
これが重要な理由は単純です。自分の割り当てを把握できるスクリプトは、それに合わせて賢く動作できます。ブロックされる前にペースを落としたり、クレジットが少なくなったときに開発者に通知したり、先に失敗してから対処するのではなく、無料キーから有料キーに自動で切り替えたりできます。そのどれにも、別の使用量エンドポイントを呼び出したり、ダッシュボードを手作業で確認したりする必要はありません。情報は、すでに要求した回答と一緒に届きます。
これは、ネイティブのエンドポイントを使う場合でも、17の互換ホストのいずれかを使う場合でも同じです。Google Maps Platform、Bing Maps REST Services、ipstackへの呼び出しと同じ形式のリクエストでも、そのプロバイダーの形式に合ったレスポンス本文に加えて、当社の割り当てヘッダーが付いて返ってきます。プロバイダーを切り替えても、この可視性が失われることはなく、むしろもともとなかった場所でそれを得られるようになります。
すべてのキーに1日あたりの無料割り当てがあります。それを超えると、リクエストはプリペイドクレジットから消費されるか、Unlimitedパッケージでカバーされます。すべてのレスポンスのヘッダーで現在の状況がわかります。1回の呼び出しではささいなことですが、トラフィックの多い1日を通して見ると本当に役立ちます。
使い捨てのスクリプト以上のものを構築するチームには、最初からこれらのヘッダーを自社のリクエストログと一緒に記録することをおすすめします。X-Quota-Free-Remainingが予想より速く減っていくという静かな傾向は、サポートチケットで気づくよりもグラフで気づくほうがはるかに安く済みます。各ヘッダーの詳細と、それがどのような条件で返されるかは/docs/rate-limits/に記載されており、認証に関する全般的な説明は/docs/authentication/にあります。