今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
Geocodioとの互換ホストが利用可能に
Geocodioはわかりやすいバッチジオコーディングで評判を築いてきたため、Geocodioを対象に作られた連携の多くは、そのバッチの動作に大きく依存しています。私たちの互換ホストは単一検索とバッチの両方のリクエストの形に正確に合わせているので、その依存が切り替えの妨げになることはありません。
このホストはGeocodioのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これはMy Geocode独自のものです。現在Geocodioのエンドポイント向けの形になっているリクエストは、単一でもバッチでも、そのまま私たちのホストに送ることができ、レスポンスは既存のコードが想定しているのと同じように解析できます。
バッチリクエストは、プラットフォームの他のすべての場所と同じ方法で数えられます。バッチ呼び出し全体ではなく、その中の住所1件ごとに1リクエストとして数えます。これにより、呼び出しに含まれる住所が1件でも多数でも、割り当ての追跡が正確に保たれます。
1回の呼び出しで送信された500件の住所のバッチは、500件の個別の呼び出しと同じく、割り当てに対して500リクエストとして計測され、無料の割り当てをすでに使い切っていればプリペイドクレジットからも500リクエスト分が差し引かれます。この細かさがあるからこそ、X-Quota-UsedとX-Credits-Remainingは、数分後にバックグラウンドの処理が追いついてから確定するのではなく、大きなバッチが完了した瞬間に正確な値になります。
認証には私たちの標準の4つの方法を使えます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータで、現在のGeocodioとの連携がすでに使っている方法に合わせられます。
料金はプラットフォーム全体で同じです。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあり、ネットワーク単位で数えられます。キーごとに1日あたり2,500件の無料リクエストが追加されます。それを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50ですべてをカバーでき、単一の検索にもバッチの各項目にも同じ料金が適用されます。
ダッシュボードのクーポンコードは、このようにバッチを多用する移行を、実際の予算を先に投じることなく試すためのよくある方法です。プリペイドクレジットやUnlimitedパッケージで本格的に資金を入れるかどうかを決める前に、アカウントにクレジット残高を追加できます。
バッチでも単一でも、すべてのレスポンスに割り当てのヘッダーが付きます。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remainingは、バッチが消費した項目数を正確に反映するので、計画を立てやすい精度が得られます。
プロジェクトで標準の互換レスポンス以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、オプションの追加フィールドがその上に加わります。明示的に要求しない限り、基本の形には手を加えません。
このホストのドキュメントは/compatibility/geocodio/にあり、既存の連携を切り替えるための一般的な手引きは/docs/compatibility/にあります。新しいホストに対してバッチ呼び出しを試してみれば、実際の件数で頼る前に、割り当てのカウントが想定どおりに動くことをすばやく確認できます。