Memperbaiki alamat - contoh

Dokumen ini menjelaskan sejumlah skenario di dunia nyata saat Address Validation API memberikan sinyal respons yang menjamin perilaku perbaikan dari sistem Anda. Lihat Ringkasan alur kerja di Mem-build logika validasi untuk konteks.

Contoh umum: fix

Bagian ini menjelaskan contoh umum saat Address Validation API memberikan sinyal respons yang menunjukkan informasi alamat berkualitas lebih rendah.

Kota dan kode pos tidak ada

Contoh ini mengilustrasikan entri yang hanya memiliki alamat jalan, tanpa kota atau kode pos.

Alamat dimasukkan Wilayah
21 45 40th street AS

Putusan untuk kota dan kode pos tidak ada

Contoh di bawah menekankan sinyal penting dari respons.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Sinyal ini menunjukkan alamat yang tidak dapat dikirim, sehingga Anda dapat membuat kueri addressComponents untuk mempelajari lebih lanjut:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API hanya menampilkan negara (Amerika Serikat) sebagai CONFIRMED. Fungsi ini menampilkan semua komponen alamat lainnya sebagai UNCONFIRMED_BUT_PLAUSIBLE, dengan beberapa penghapusan penting pada data, seperti lokalitas dan kode pos.

Nomor jalan tidak ada

Contoh ini menunjukkan nomor jalan yang tidak ada.

Alamat dimasukkan Wilayah
Buckingham Palace Road, SW1W 9TQ London Inggris Raya
Verdict for missing street number
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity adalah ROUTE, yang menunjukkan kecocokan dengan jalan, tetapi tidak cukup informasi untuk sampai ke tempat. Selain itu, properti addressComplete tidak ada di verdict, sehingga properti ini false. Kueri lebih lanjut dari objek address menunjukkan jenis komponen yang tidak ada:

"missingComponentTypes": [
        "street_number"
      ]

Contoh kasus ekstrem: perbaikan

Dalam beberapa situasi, apakah Anda memperbaiki, mengonfirmasi, atau menerima alamat bergantung pada skenario bisnis Anda. Contoh di bawah mengilustrasikan skenario yang mungkin tidak sepenuhnya termasuk dalam kategori perbaikan.

Nomor jalan belum dikonfirmasi

Dalam skenario ini, Address Validation API tidak dapat mengonfirmasi nomor jalan yang diberikan, tetapi menunjukkan bahwa alamat sudah lengkap.

Alamat dimasukkan Wilayah
84 Buckingham Palace Road, SW1W 9TQ, London Inggris Raya

Putusan untuk nomor jalan yang belum dikonfirmasi

Contoh di bawah ini menekankan sinyal penting.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true
}

Sebaiknya selidiki kombinasi perincian validasi hanya untuk perkiraan tingkat premis beserta komponen yang belum dikonfirmasi. Kueri properti addressComponents menampilkan componentType yang belum dikonfirmasi berikut:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Di sini, confirmation_level dari street_number ditetapkan ke UNCONFIRMED_BUT_PLAUSIBLE. Tidak dikonfirmasi berarti layanan tidak dapat mencocokkan nomor jalan 84 dalam set datanya, dan mungkin berarti data komponen masih dapat valid.

Subpremis tidak ada

Skenario ini menjelaskan alamat yang hanya tidak memiliki sub-premis, seperti nomor apartemen atau departemen. Jika tidak, Address Validation API dapat sepenuhnya memvalidasi alamat tersebut. Seperti halnya jika komponen alamat tidak ada, addressComplete adalah false sehingga tidak ada pada pemeriksaan verdict secara manual.

Sebagai ilustrasi, misalkan pelanggan memasukkan alamat yang valid untuk kantor penilai kota San Francisco, tetapi tidak memasukkan nomor ruangan dari input.

Alamat dimasukkan Wilayah
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 AS

Verdict for missing subpremise

Dalam contoh ini, verdict tidak menampilkan properti addressComplete, sehingga bernilai false. Oleh karena itu, Anda tahu bahwa setidaknya ada satu elemen alamat yang tidak terduga, tidak terselesaikan, atau tidak ada.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

Kueri address mengungkapkan hal berikut:

"missingComponentTypes": [
        "subpremise"
      ]

Setelah penyelidikan lebih lanjut, data USPS memberikan kode dpvConfirmation dari D, yang juga menunjukkan sub-premis yang hilang.