Mengirim permintaan validasi alamat

Kirim permintaan validasi alamat dengan mengeluarkan 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 sub-isian, yaitu:

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 dari jenis PostalAddress, yang harus berisi di setidaknya satu entri di addressLines.

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

• regionCode — Direkomendasikan. Ini adalah isian opsional, namun jika dihilangkan, Address Validation API menyimpulkan region dari alamat tersebut. Namun, untuk hasil terbaik hasil, sertakan regionCode jika Anda mengetahuinya. Untuk mengetahui daftar wilayah yang didukung, lihat wilayah yang didukung.
• addressLines — Wajib. Array dengan alamat yang menjelaskan struktur alamat.

Lihat PostalAddress di panduan referensi.

Opsi USPS CASSTM

United States POST Service® (USPS®)¹ mengelola Sistem Dukungan Akurasi Coding (CASSTM) untuk mendukung dan menjalankan sertifikasi penyedia validasi alamat.

Catatan: Address Validation API dikonfirmasi sebagai layanan Bersertifikasi CASSTM. Ini berarti layanan telah dikonfirmasi atas kemampuannya untuk mengisi alamat yang tidak ada informasi standar, menstandarkannya, dan memperbaruinya ke informasi terbaru dan akurat alamat IPv6.

Khusus region 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 nama 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 di luar wilayah AS dan Humas, Google tidak menyarankan pengaktifan fitur ini.

Cobalah!

API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda bisa membiasakan diri dengan API dan opsi API.

1. Pilih ikon API, , di sisi kanan halaman.

2. Jika ingin, luaskan Show standar parameter dan setel fields parameter ke kolom penyamaran.

3. Jika ingin, edit Isi permintaan.

4. Pilih tombol Execute. Pada dialog, pilih akun yang yang ingin Anda gunakan untuk membuat permintaan.

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

---

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