Geocode dengan akurasi yang ditingkatkan

Produk atau fitur ini bersifat Eksperimental (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Metode GeocodeAddress dan SearchDestinations mendukung parameter effort opsional yang memungkinkan Anda mengontrol kompromi antara latensi respons dan akurasi resolusi alamat.

Meskipun geocoding standar menangani alamat pos yang diformat dengan baik dalam latensi sub-detik, input di dunia nyata sering kali tidak lengkap, informal, atau kompleks (misalnya, "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai" atau "where the warriors play, sf"). Dengan mengonfigurasi tingkat effort yang lebih tinggi, Anda dapat menginstruksikan Geocoding API untuk menerapkan penalaran dan disambiguasi yang diperluas untuk menyelesaikan alamat yang sulit.

Penting: Fitur ini tersedia di saluran v4alpha. Informasi selengkapnya tentang saluran tahap peluncuran.

Tingkat upaya

Tentukan salah satu nilai berikut untuk parameter effort:

Tingkat upaya	Deskripsi	Latensi umum	Kasus penggunaan yang direkomendasikan
EFFORT_UNSPECIFIED	Nilai default. Berperilaku sama seperti upaya LOW.	Sub-second	Geocoding standar default.
LOW	Mengoptimalkan waktu respons tercepat. Tidak melakukan penelusuran yang diperluas atau disambiguasi untuk alamat yang sulit.	Sub-second	Pencarian interaktif real-time, validasi alamat standar bervolume tinggi.
MEDIUM	Menyeimbangkan kecepatan dan akurasi. Sebagian besar permintaan ditampilkan dengan latensi rendah standar. Untuk alamat yang ambigu atau sulit, layanan ini menerapkan pemrosesan tambahan untuk meningkatkan akurasi, yang mungkin memerlukan waktu hingga beberapa detik.	Kurang dari satu detik untuk alamat standar; hingga beberapa detik (≤ 4 detik) untuk alamat yang ambigu	Alur kerja pengguna interaktif (seperti konfirmasi alamat saat checkout) yang memungkinkan pengguna menoleransi jeda singkat.
HIGH	Memaksimalkan akurasi resolusi alamat untuk alamat yang tidak lengkap, informal, atau kompleks. Waktu respons mungkin jauh lebih lama.	Hingga 20 detik untuk alamat yang kompleks	Pemrosesan latar belakang, kelompok pengodean geografis, pengiriman logistik, atau penyempurnaan alamat pasca-checkout asinkron.

Catatan: Tingkat upaya MEDIUM dan HIGH menggunakan model Gemini untuk memproses dan mendisambiguasi alamat yang kompleks. Respons diselesaikan menggunakan AI dan mungkin membuat kesalahan.

Contoh permintaan

Menelusuri tujuan (SearchDestinations)

Sertakan kolom effort dalam isi permintaan JSON dari permintaan POST Anda ke https://geocode.googleapis.com/v4alpha/geocode/destinations. Parameter effort terutama memengaruhi resolusi addressQuery:

curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai"
  },
  "effort": "HIGH"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

Memberi geocode pada alamat (GeocodeAddress)

Teruskan parameter effort sebagai parameter kueri URL dalam permintaan GET Anda ke endpoint /v4alpha/:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4alpha/geocode/address/where+the+warriors+play,+sf?effort=MEDIUM"

Memitigasi dampak latensi

Saat menggunakan upaya MEDIUM atau HIGH dalam aplikasi Anda, mengirim permintaan satu penerusan adalah integrasi yang paling sederhana, tetapi permintaan dalam mode ini dapat menimbulkan latensi yang lebih tinggi, yang dapat menunda alur kerja sinkron, ditampilkan kepada pengguna, dan sensitif terhadap latensi.

Untuk mengurangi dampak latensi ini pada alur pengguna interaktif (seperti checkout atau pemesanan), Anda dapat menggunakan alur kerja multi-pass:

1. Pass 1 (Interaktif): Kirim permintaan sinkron dengan effort=LOW (atau default) untuk segera memvalidasi alamat dengan latensi di bawah satu detik.
2. Langkah 2 (Latar Belakang): Kirim permintaan tindak lanjut asinkron dengan effort=MEDIUM atau effort=HIGH (misalnya, setelah checkout atau sebelum pengiriman) untuk me-resolve alamat yang kompleks menjadi koordinat, pintu masuk, dan titik navigasi presisi tinggi tanpa memblokir pengguna.

Batas penggunaan

Selama tahap peluncuran Eksperimental (v4alpha), permintaan dengan effort yang ditetapkan ke MEDIUM atau HIGH tunduk pada pembatasan kapasitas yang lebih ketat daripada permintaan standar (LOW). Jika aplikasi Anda melebihi batas kapasitas ini, API akan menampilkan error RESOURCE_EXHAUSTED (HTTP 429). Jika Anda mengalami error HTTP 429 atau memerlukan kuota yang lebih tinggi untuk kasus penggunaan Anda, hubungi kami melalui saluran masukan.

Masukan

Fitur ini adalah fitur eksperimental Geocoding API. Kami akan menghargai masukan di [e-mail].