バッチ ジオコーディング API - 無料の一括アドレスから座標への変換
最大 10 個の自由形式アドレスの配列を送信し、それぞれの座標を受け取ります。 住所は並行してジオコーディングされます。 個々の失敗は、バッチ全体が失敗することなく、そのアドレスに関するエラー メッセージを返します。 応答には、合計数、解決済み数、失敗数が含まれます。
Code examples
curl -X POST https://api.botoi.com/v1/geo/batch \
-H "Content-Type: application/json" \
-d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'When to use this API
顧客の所在地を地図上にプロットする
CRM エクスポートから顧客住所のリストをジオコーディングします。 座標を使用して、地域計画、配送ルート、または販売範囲分析のために地図上にピンを配置します。
CSV インポートを座標で強化する
アップロードされたアドレスを含む CSV ファイルを処理します。 データベースに保存する前に、住所列をバッチ ジオコーディングし、緯度と経度を各行に追加します。
フォーム送信で複数のアドレスを検証する
ユーザーが複数住所フォーム (請求書 + 配送 + 代替住所など) を送信する場合、1 回の API 呼び出しですべての住所をジオコーディングします。 提出を受け入れる前に、解決できなかったものにフラグを立ててください。
Frequently asked questions
リクエストごとのアドレスの最大数はどれくらいですか?
リクエストごとに最大 10 個のアドレスを送信できます。 バッチが大きい場合は、リストを 10 個のチャンクに分割し、複数のリクエストを送信します。
1 つのアドレスに障害が発生した場合はどうなりますか?
失敗したアドレスは、lat: null、lng: null、およびエラー メッセージを返します。 残りのバッチは通常どおり処理されます。 応答内の失敗数を確認して、問題のあるアドレスを特定します。
ジオコーディングの呼び出しは並行して行われますか?
はい。 応答時間を短縮するために、バッチ内のすべての住所が同時にジオコーディングされます。 10 個の住所のバッチには、単一のジオコード リクエストとほぼ同じ時間がかかります。
10 を超える住所をジオコーディングできますか?
単一のリクエストではありません。 リストを 10 個のバッチに分割し、複数のリクエストを送信します。 有料プランでは、1 秒あたり複数のバッチ リクエストを送信できます。
これは /v1/geo/geocode と同じジオコーダーですか?
はい。 バッチ エンドポイントは、単一住所エンドポイントと同じ OpenStreetMap Nominatim ジオコーダーを使用します。 同じ入力に対する結果は同じです。
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.