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
uspsDatauntuk 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
- Layanan yang akan diaktifkan:
addressvalidation.googleapis.com - Autentikasi: Kunci API, OAuth 2.0, Akun layanan
- Mulai: Menyiapkan Address Validation API
- Referensi: Referensi Address Validation API
- Harga: Penggunaan dan penagihan Address Validation API
- Kebijakan: Kebijakan Address Validation API
- Catatan rilis: Catatan rilis Address Validation API
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
addressCompletedihilangkan dari verdict jika nilainya adalahfalse, sehingga kode yang mengharapkan kolom tersebut ada dapat salah membaca alamat yang tidak lengkap. Perbaikan: Perlakukan propertiaddressCompleteyang tidak ada sebagaifalse, atau periksa keberadaan properti tersebut. Lihat /maps/documentation/address-validation/understand-response. - Masalah: Jika
regionCodedihilangkan, API akan menyimpulkan wilayah dari alamat, yang dapat memberikan hasil yang lebih lemah. Perbaikan: SertakanregionCodediPostalAddressjika Anda mengetahuinya. Lihat /maps/documentation/address-validation/requests-validate-address. - Masalah: Objek
uspsDatatidak dijamin terisi sepenuhnya untuk setiap alamat AS yang divalidasi. Perbaikan: Jangan mengandalkanuspsDatasebagai satu-satunya sinyal validasi; gunakan juga komponen verdict dan address. Lihat /maps/documentation/address-validation/handle-us-address. - Masalah: Masukan yang dikirim dengan
provideValidationFeedbackharus merujuk keresponseIddari panggilanvalidateAddresspertama dalam urutan, bukan panggilan berikutnya. Perbaikan: SimpanresponseIddari responsvalidateAddresspertama 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.
- Menampilkan alamat yang divalidasi untuk alamat atau alamat parsial yang ditentukan.
- Menampilkan koordinat lintang/bujur untuk alamat yang divalidasi.
- Menampilkan ID tempat Google untuk alamat yang divalidasi.
- Gunakan sertifikasi Coding Accuracy Support System (CASS) United States Postal Service (USPS) untuk validasi alamat.
- Menampilkan informasi tentang apakah alamat yang divalidasi adalah bisnis, tempat tinggal, atau PO box.
- Menampilkan metadata pengiriman United States Postal Service (USPS) untuk alamat yang divalidasi.
- Menampilkan versi bahasa Inggris dari alamat yang divalidasi. Pratinjau
- Menampilkan Plus Code untuk alamat yang divalidasi.