Langsung ke konten
POST AI agent ready /v1/geo/batch

Batch Geocoding API - Alamat Massal Gratis ke Koordinat

Kirim array hingga 10 alamat bentuk bebas dan terima koordinat untuk masing-masing alamat. Alamat di-geocode secara paralel. Kegagalan individu mengembalikan pesan kesalahan untuk alamat tersebut tanpa menggagalkan seluruh batch. Responsnya mencakup jumlah total, terselesaikan, dan gagal.

Parameters

arrayrequired

Array of address strings to geocode (max 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

Plot lokasi pelanggan di peta

Geocode daftar alamat pelanggan dari ekspor CRM Anda. Gunakan koordinat untuk menempatkan pin pada peta untuk perencanaan wilayah, rute pengiriman, atau analisis cakupan penjualan.

Perkaya impor CSV dengan koordinat

Memproses file CSV yang diunggah yang berisi alamat. Batch geocode kolom alamat dan tambahkan garis lintang dan bujur ke setiap baris sebelum menyimpannya di database Anda.

Validasi beberapa alamat dalam pengiriman formulir

Saat pengguna mengirimkan formulir multi-alamat (misalnya, penagihan + pengiriman + alternatif), lakukan geocode semua alamat dalam satu panggilan API. Tandai semua masalah yang gagal diselesaikan sebelum menerima kiriman.

Frequently asked questions

Berapa jumlah maksimum alamat per permintaan?
Anda dapat mengirim hingga 10 alamat per permintaan. Untuk kelompok yang lebih besar, bagi daftar Anda menjadi 10 bagian dan kirim beberapa permintaan.
Apa yang terjadi jika satu alamat gagal?
Alamat yang gagal mengembalikan lat: null, lng: null, dan pesan kesalahan. Proses batch lainnya normal. Periksa penghitungan yang gagal dalam respons untuk mengidentifikasi alamat yang bermasalah.
Apakah panggilan geocoding dilakukan secara paralel?
Ya. Semua alamat dalam batch di-geocode secara bersamaan untuk waktu respons yang lebih cepat. Kumpulan 10 alamat membutuhkan waktu yang kira-kira sama dengan satu permintaan geocode.
Bisakah saya melakukan geocode lebih dari 10 alamat?
Tidak dalam satu permintaan. Bagi daftar Anda menjadi 10 kelompok dan kirim beberapa permintaan. Dengan paket berbayar, Anda dapat mengirim beberapa permintaan batch per detik.
Apakah ini geocoder yang sama dengan /v1/geo/geocode?
Ya. Titik akhir batch menggunakan geocoder OpenStreetMap Nominatim yang sama dengan titik akhir satu alamat. Hasilnya identik untuk masukan yang sama.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs