Referensi cepat Address Validation API

Address Validation API menerima alamat, mengidentifikasi komponennya dan memvalidasinya, menstandarkan alamat untuk pengiriman, dan menampilkan koordinat lintang/bujur yang paling akurat untuk alamat tersebut. Untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan pemrosesan CASS USPS secara opsional.

Address Validation API: fakta penting

  • Produk: Address Validation API
  • Kategori: Tempat
  • Platform: Layanan web (REST)
  • Berjalan di: Server (kode backend)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Address Validation API
  • Ketersediaan regional: Terbatas. Negara yang didukung dan kualitas data bervariasi menurut negara, dan beberapa negara masih dalam versi Pratinjau. Metadata perumahan dan komersial hanya ditampilkan untuk negara yang ditandai di halaman cakupan. USPS CASS hanya didukung untuk Amerika Serikat dan Puerto Riko. (detail cakupan)

Address Validation API: kapan harus menggunakannya

Gunakan Address Validation API jika:

  • Anda perlu memeriksa apakah alamat merujuk ke tempat yang sebenarnya dan menemukan komponen mana yang tidak ada atau mungkin salah.
  • Anda perlu menstandarkan dan melengkapi alamat untuk pengiriman, misalnya selama alur checkout.
  • Anda memerlukan validasi bersertifikasi CASS USPS dan uspsData untuk alamat di AS atau Puerto Riko.
  • Anda memerlukan metadata alamat tempat tinggal atau komersial untuk negara yang tercantum di halaman cakupan.

Jangan gunakan Address Validation API jika:

  • Anda hanya perlu mengonversi alamat menjadi lintang/bujur dan tidak perlu memvalidasi komponen alamat satu per satu. Gunakan Geocoding API.
  • Anda memerlukan detail tujuan yang sangat lokal seperti pintu masuk bangunan, garis batas bangunan, atau titik navigasi. Gunakan Geocoding API.

Address Validation API: penyiapan

Paket Address Validation API resmi:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

Address Validation API: kesalahan umum

  • Masalah: Properti addressComplete dihilangkan dari verdict jika nilainya adalah false, sehingga kode yang mengharapkan kolom tersebut ada dapat salah membaca alamat yang tidak lengkap. Perbaikan: Perlakukan properti addressComplete yang tidak ada sebagai false, atau periksa keberadaan properti tersebut. Lihat /maps/documentation/address-validation/understand-response.
  • Masalah: Jika regionCode dihilangkan, API akan menyimpulkan wilayah dari alamat, yang dapat memberikan hasil yang lebih lemah. Perbaikan: Sertakan regionCode di PostalAddress jika Anda mengetahuinya. Lihat /maps/documentation/address-validation/requests-validate-address.
  • Masalah: Objek uspsData tidak dijamin terisi sepenuhnya untuk setiap alamat AS yang divalidasi. Perbaikan: Jangan mengandalkan uspsData sebagai satu-satunya sinyal validasi; gunakan juga komponen verdict dan address. Lihat /maps/documentation/address-validation/handle-us-address.
  • Masalah: Masukan yang dikirim dengan provideValidationFeedback harus merujuk ke responseId dari panggilan validateAddress pertama dalam urutan, bukan panggilan berikutnya. Perbaikan: Simpan responseId dari respons validateAddress pertama dan kirimkan dalam permintaan masukan. Lihat /maps/documentation/address-validation/handle-updated-address.

Yang dapat Anda lakukan dengan Address Validation API

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.