今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
住所リスト向けの新しい一括エンドポイント
住所のリストを1件ずつ、HTTP呼び出しを次々に行って処理する方法は、少量であれば問題なく機能しますが、ある程度の規模になるとすぐに手間がかかるようになります。私たちは現在、住所リスト全体を1回の一括呼び出しで送信できるようにしており、料金の仕組みを何も変えることなく、大きなリストの処理に必要な往復の回数を減らしています。
ここでのカウントのルールは、プラットフォームの他のすべての場所で適用しているものとまったく同じです。一括呼び出しに含まれる各住所がそれぞれ1件のリクエストとしてカウントされ、呼び出し全体で1件になるわけではありません。500件の住所のリストを1回の一括呼び出しで送信すると、適用される割り当てが1日あたりの無料割り当て、1リクエストあたり€0.0001のプリペイドクレジット、Unlimitedパッケージの対象のいずれであっても、500件のリクエストを消費します。作業を1回の呼び出しにまとめても、多数の小さな呼び出しに分けて送信しても、割引もペナルティもありません。
割り当てヘッダーも一括呼び出しを正確に反映します。X-Quota-Used、X-Quota-Free-Remaining、X-Credits-Remainingはいずれも、その呼び出しで実際に処理された住所の数だけ変動します。そのため、大きな一括リクエストは、500回の個別の呼び出しを行った場合と同じように表示上の割り当てを更新します。ただし、往復は500回ではなく1回で済みます。
これはまさに、以前なら住所1件ずつの呼び出しをループで囲むコードを書く必要があったような処理を対象にしています。ジオコーディングが必要な顧客リストのインポート、住所データベースのクリーンアップ、あるいは1回のユーザー操作に応じてではなくスケジュールに従って実行される大規模なバッチジョブの準備などです。そのリストを1回の一括呼び出しで送信すると、多数の個別のHTTP接続を管理するオーバーヘッドが減ります。これは、当社の制約とは別に独自の接続やレートの制約があるインフラで実行されるジョブに特に役立ちます。
認証と全般的な挙動は変わりません。同じ4つのキーの送信方法が使え、同じ割り当てのルールが適用され、同じ無料割り当てで、実際の費用が発生する前に十分なテストができます。他の住所ベースの検索と同様に、ジオコーディングと逆ジオコーディングの結果は、実際の地点データを返すために現在開発中のバックエンドの一部です。そのため、この一括処理機能については、特にリクエストの形式とカウントの挙動を中心にドキュメント化しています。
リクエストの書式を含む一括リクエストの送信に関する完全なドキュメントは、/docs/forward-geocoding/と/docs/reverse-geocoding/でご覧いただけます。現在のワークフローで住所1件ずつの呼び出しをループしている場合、一度に数件以上の住所を処理するものであれば検討する価値があります。