Mengirim permintaan validasi alamat

Developer Wilayah Ekonomi Eropa (EEA)

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

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-kolom:

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 menghapus 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:

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 paling sederhana harus berisi subkolom berikut:

  • regionCode — Direkomendasikan. Kolom ini bersifat opsional, tetapi jika tidak diisi, Address Validation API akan menyimpulkan region dari alamat. Namun, untuk hasil terbaik, sertakan regionCode jika Anda mengetahuinya. Untuk mengetahui daftar region yang didukung, lihat region yang didukung.
  • addressLines — Wajib diisi. 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 mensertifikasi penyedia validasi alamat.

Khusus untuk wilayah Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan pemrosesan CASS dengan menyetel enableUspsCass ke true di isi permintaan. Untuk hasil terbaik saat menggunakan CASS, berikan alamat yang mencakup 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!

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 secara opsional.

  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 tidak 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™. ↩