Kirim permintaan validasi alamat dengan mengeluarkan permintaan POST ke salah satu endpoint berikut:
- validateAddress (REST)
- ValidateAddress (gRPC)
Permintaan Anda juga harus meneruskan isi permintaan JSON ke permintaan yang menentukan alamat yang akan divalidasi. Isi permintaan berikut berisi satu kolom dan tiga subkolom:
curl -X POST -d '{ "address": { "regionCode": "US", "locality": "Mountain View", "addressLines": ["1600 Amphitheatre Pkwy"] } }' \ -H 'Content-Type: application/json' \ "https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"
Anda juga dapat menghilangkan locality
dan menentukannya sebagai elemen dalam
array addressLines
:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Kolom permintaan alamat
Isi permintaan terdiri dari satu kolom:
address
— kolom dari jenisPostalAddress
, yang harus berisi setidaknya satu entri diaddressLines
.
Saat mengirim kolom address
ke Address Validation API, Anda hanya perlu menyediakan satu kolom: addressLines
. Namun, permintaan alamat yang paling sederhana
harus berisi subkolom berikut:
regionCode
— Direkomendasikan. Kolom ini opsional, tetapi jika dihilangkan, Address Validation API akan menyimpulkan region dari alamat ini. Namun, untuk hasil terbaik, sertakanregionCode
jika Anda mengetahuinya. Untuk mengetahui daftar wilayah yang didukung, lihat wilayah yang didukung.addressLines
— Wajib. Array dengan alamat yang menjelaskan struktur alamat yang lebih rendah.
Lihat PostalAddress di panduan referensi. |
Opsi USPS CASS™
United States Postal Service® (USPS®)1 mengelola Coding Accuracy Support System (CASS™) untuk mendukung dan memberikan sertifikasi kepada penyedia validasi alamat.
Khusus untuk wilayah Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan pemrosesan CASS dengan menetapkan
enableUspsCass
ke true
dalam isi permintaan. Untuk mendapatkan hasil terbaik saat menggunakan
CASS, berikan alamat yang menyertakan jalan dan nomor jalan beserta
kota, negara bagian, dan kode pos:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
Cobalah!
API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda dapat memahami API dan opsi API.
Pilih ikon API, , di sisi kanan halaman.
Jika ingin, luaskan Tampilkan parameter standar dan tetapkan parameter
fields
ke mask kolom.Jika ingin, edit Isi permintaan.
Pilih tombol Execute. Di dialog, pilih akun yang ingin digunakan untuk membuat permintaan.
Di panel API Explorer, pilih ikon luaskan, , untuk meluaskan jendela API Explorer.
-
Google Maps Platform adalah Penerima Lisensi non-eksklusif dari United States POST Service®. Merek dagang berikut dimiliki oleh United States POST Service® dan digunakan dengan izin: United States postal Service®, CASSTM, CASS CertifiedTM. ↩