Memahami respons validasi alamat dasar

Respons Address Validation API berisi properti tingkat atas berikut:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

Properti verdict

Properti verdict meringkas hasil validasi alamat dan harus menjadi properti pertama yang dievaluasi saat membuat logika pemeriksaan alamat. Properti ini dapat menampilkan berbagai kolom, bergantung pada kualitas alamat output. Misalnya, berikut menunjukkan properti verdict alamat berkualitas baik, yang menampilkan kolom berikut untuk permintaan tertentu ini:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

Bagian berikut meringkas semua kolom dalam properti verdict.

Lihat Verdict di panduan referensi.

Granularitas alamat

Granularitas alamat mengacu pada tingkat detail yang digunakan dalam menentukan spesifisitas alamat atau geocode. Spesifisitas alamat dalam respons validationGranularity adalah sinyal utama untuk menentukan apakah alamat dapat dikirim atau tidak.

Properti verdict menampilkan sinyal granularitas berikut:

  • inputGranularity — Menjelaskan tingkat detail yang diambil dari alamat yang dikirim ke Address Validation di Maps JavaScript API. Tingkat detail alamat dalam permintaan memengaruhi tingkat detail alamat dalam respons validasi. Misalnya, alamat dengan inputGranularity di bawah tingkat PREMISE biasanya tidak menghasilkan validationGranularity ke tingkat PREMISE.
  • validationGranularity — Tingkat granularitas yang dapat digunakan oleh Address Validation di Maps JavaScript API untuk memvalidasi alamat sepenuhnya. Dalam sebagian besar kasus, a tingkat granularitas PREMISE atau SUB_PREMISE menunjukkan alamat berkualitas yang kemungkinan dapat dikirim.
  • geocodeGranularity — Menjelaskan tingkat detail geocode yang terkait dengan alamat. Misalnya, catatan Google mungkin menunjukkan keberadaan nomor apartemen, tetapi tidak menunjukkan lokasi yang tepat untuk apartemen tertentu dalam kompleks apartemen besar. Dalam hal ini, validationGranularity adalah SUB_PREMISE tetapi geocodeGranularity adalah PREMISE.
Lihat Granularitas di panduan referensi.

Kelengkapan alamat

Verdict menampilkan properti addressComplete sebagai sinyal untuk alamat berkualitas tinggi, yang berarti secara khusus tidak memiliki komponen yang hilang, tidak terselesaikan, atau tidak terduga:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

Jika alamat memiliki komponen yang hilang, tidak terselesaikan, atau tidak terduga, kolom akan ditetapkan ke false.

Lihat addressComplete di bagian Verdict dan Alamat di panduan referensi.

Kualitas alamat

Beberapa kolom yang mungkin ada menunjukkan masalah dengan komponen alamat, atau penyesuaian terhadapnya, seperti komponen alamat yang disimpulkan atau hilang. Misalnya, properti verdict berikut menunjukkan alamat dengan komponen yang belum dikonfirmasi dan kolom addressComplete yang hilang:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
Lihat Verdict di panduan referensi.

Kemungkinan tindakan berikutnya

Kolom possibleNextAction verdict menawarkan ringkasan interpretatif respons API, yang dimaksudkan untuk membantu menentukan potensi tindakan berikutnya yang akan diambil. Kolom ini berasal dari kolom lain dalam respons API dan tidak boleh dianggap sebagai jaminan akurasi atau kemampuan pengiriman alamat.

Properti address dan addressComponent

Properti address menyediakan format untuk alamat yang diproses yang diberikan dalam permintaan, beserta ringkasan tingkat komponen alamat, termasuk bagian alamat yang salah eja, bagian yang salah diganti, dan bagian yang hilang disimpulkan.

Lihat Address di panduan referensi.

Properti addressComponent adalah subkomponen address yang memberikan daftar mendetail elemen—atau komponen—alamat yang telah diproses oleh Address Validation di Maps JavaScript API. API mengidentifikasi setiap kolom komponen yang disediakan berdasarkan nama, jenis, dan tingkat konfirmasinya.

Lihat addressComponent di panduan referensi.

Properti geocode

Properti geocode menunjukkan lokasi yang di-geocode yang terkait dengan alamat input. Properti ini memberikan detail tentang lokasi itu sendiri, seperti ID tempatnya.

Lihat Geocode di panduan referensi.

Properti metadata

Properti ini mungkin tidak diisi untuk setiap alamat yang diproses oleh Address Validation di Maps JavaScript API, tetapi menunjukkan apakah alamat tersebut berjenis perumahan, bisnis, atau PO Box.

Lihat cakupan Address Validation API dan referensi untuk Address metadata.

Properti uspsData

Properti ini memberikan informasi yang berguna untuk alamat pos Amerika Serikat. Namun, properti ini tidak dijamin akan diisi sepenuhnya untuk setiap alamat yang divalidasi oleh layanan. Oleh karena itu, Anda tidak boleh mengandalkan properti ini sebagai satu-satunya cara untuk memvalidasi alamat, tetapi juga harus memeriksa verdict dan address.

Lihat Menangani alamat Amerika Serikat dan referensi untuk USPSData.