Memperbaiki alamat - contoh

Dokumen ini menjelaskan sejumlah skenario dunia nyata saat Address Validation API memberikan sinyal respons yang memerlukan perilaku perbaikan dari sistem Anda. Contoh di sini bersifat ilustratif, tetapi tidak lengkap. Lihat Ringkasan alur kerja di Membangun logika validasi untuk mengetahui konteksnya.

Tips: Buka demo Address Validation dan coba validasi sendiri contoh alamatnya.

Contoh umum: perbaikan

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, tanpa kota atau kode pos.

Alamat yang dimasukkan	Wilayah
21 45 40th street	AS

Keputusan untuk kota dan kode pos yang 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 mengkueri 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. API ini menampilkan semua komponen alamat lainnya sebagai UNCONFIRMED_BUT_PLAUSIBLE, dengan beberapa penghilangan penting pada data, seperti lokalitas dan kode pos.

Tindakan: Untuk alamat ini, tindakan yang disarankan adalah meminta informasi yang tidak ada kepada pengguna.

Nomor jalan tidak ada

Contoh ini menunjukkan nomor jalan yang tidak ada.

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

Keputusan untuk nomor jalan yang tidak ada

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

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

"missingComponentTypes": [
        "street_number"
      ]

Tindakan: Dalam hal ini, tindakan yang disarankan adalah meminta informasi yang tidak ada kepada pengguna.

Contoh kasus ekstrem: perbaikan

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

Nomor jalan yang belum dikonfirmasi

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

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

Keputusan untuk nomor jalan yang belum dikonfirmasi

Contoh di bawah menekankan sinyal penting.

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

Sebaiknya selidiki kombinasi perincian validasi hanya untuk perkiraan tingkat bangunan 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. Unconfirmed berarti layanan tidak dapat mencocokkan nomor jalan 84 dalam set datanya, dan plausible berarti data komponen masih dapat valid.

Tindakan: Anda dapat menerima input seperti yang dimasukkan, atau mengonfirmasi dengan pelanggan untuk menentukan apakah nomor jalan yang dimasukkan memang dimaksudkan atau merupakan kesalahan. Respons Anda bergantung pada tingkat risiko yang terkait dengan pengiriman Anda. Lihat Panduan penerapan di Membangun logika validasi.

Subpremis tidak ada

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

Catatan: Di beberapa negara, Address Validation API tidak dapat mendeteksi subpremis yang tidak ada; sedangkan di AS, SUB_PREMISE yang tidak ada menunjukkan alamat yang tidak dapat dikirim.

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

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

Keputusan untuk subpremis yang tidak ada

Dalam contoh ini, verdict tidak menampilkan properti addressComplete, sehingga nilainya adalah false. Oleh karena itu, Anda tahu bahwa setidaknya satu elemen alamat 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 D, yang juga menunjukkan subpremis yang tidak ada.

Tindakan: Untuk alamat ini, tindakan yang disarankan adalah meminta informasi yang tidak ada kepada pengguna.