Mengirim permintaan validasi alamat

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.

Kirim permintaan Address Validation dengan membuat permintaan POST ke salah satu endpoint berikut:

• validateAddress (REST)
• ValidateAddress (gRPC)

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

APIs Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami API dan opsi API:

Cobalah!

Kolom permintaan alamat

Isi permintaan terdiri dari satu kolom:

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

Saat mengirim kolom address ke Address Validation API, Anda hanya perlu memberikan satu kolom: addressLines. Namun, permintaan alamat yang paling sederhana harus berisi subkolom berikut:

• regionCode — Direkomendasikan. Kolom ini bersifat opsional, tetapi jika dihilangkan, Address Validation API akan menyimpulkan wilayah 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 CASS™

United States Postal Service® (USPS®)¹ mengelola Coding Accuracy Support System (CASS™) untuk mendukung dan menyertifikasi penyedia validasi alamat.

Catatan: Address Validation API dikonfirmasi sebagai layanan CASS-Certified™. Artinya, layanan ini dipastikan dapat mengisi informasi alamat yang tidak ada, menstandarkannya, dan memperbaruinya ke alamat terbaru dan paling 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 AS dan PR, Google tidak merekomendasikan untuk mengaktifkan fitur ini.

Cobalah!

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

1. Pilih ikon API api di sisi kanan halaman.

2. Edit parameter permintaan jika perlu.

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

4. Di panel APIs Explorer, pilih ikon layar penuh fullscreen untuk meluaskan jendela APIs 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®, CASS™, CASS Certified™. ↩