Mengirim permintaan validasi alamat

Kirim permintaan validasi alamat dengan mengajukan permintaan POST ke salah satu endpoint berikut:

• validateAddress (REST)
• ValidateAddress (gRPC)

Catatan: Dokumentasi ini menggunakan REST untuk contohnya, tetapi pendekatannya mirip dengan 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"]
  },
}

Cobalah!

Kolom permintaan alamat

Isi permintaan terdiri dari satu kolom:

• address — kolom jenis PostalAddress, yang harus berisi setidaknya satu entri di addressLines.

Saat mengirimkan 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. Ini adalah kolom opsional, tetapi jika dihilangkan, Address Validation API akan menyimpulkan region dari alamat. Namun, untuk hasil terbaik, sertakan regionCode 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 dalam panduan referensi.

Opsi USPS CASSTM

United States Postal Service® (USPS®)¹ menggunakan Coding Accuracy Support System (CASSTM) untuk mendukung dan mensertifikasi penyedia validasi alamat.

Catatan: Address Validation API dikonfirmasi sebagai layanan CASS-CertifiedTM. Artinya, layanan telah dikonfirmasi atas kemampuannya untuk mengisi informasi alamat yang belum ada, menstandarkan, dan memperbaruinya ke alamat terbaru dan akurat.

Khusus untuk wilayah AS dan PR, Anda dapat mengaktifkan pemrosesan CASS dengan menetapkan enableUspsCass ke true dalam isi permintaan. Untuk 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
}

Catatan: Jika Anda tidak memerlukan pemrosesan CASS, atau jika Anda memvalidasi alamat di luar wilayah Amerika Serikat dan PR, Google tidak merekomendasikan pengaktifan fitur ini.

Cobalah!

API Explorer memungkinkan Anda membuat permintaan contoh sehingga Anda dapat memahami opsi API dan API.

1. Jika ingin, luaskan Show standard parameter dan setel parameter fields ke mask kolom.

2. Jika perlu, edit Isi permintaan.

3. Pilih tombol Execute. Dalam dialog, pilih akun yang ingin digunakan untuk membuat permintaan.

4. Di panel API Explorer, pilih ikon luaskan, , untuk meluaskan jendela API Explorer.

---

1. Google Maps Platform adalah Penerima Lisensi non-eksklusif dari United States Postal Service®. Merek dagang berikut dimiliki oleh United States Postal Service® dan digunakan dengan izin: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩