Memperbaiki alamat - contoh

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

Catatan: contoh di sini hanyalah ilustrasi, tetapi tidak lengkap.

Contoh umum: memperbaiki

Bagian ini menjelaskan contoh umum saat Address Validation API menyediakan 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
Jalan Basuki Rahmat No. 98	AS

Putusan untuk kota dan kode pos tidak ada

Contoh di bawah ini 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. Metode ini akan menampilkan semua komponen alamat lainnya sebagai UNCONFIRMED_BUT_PLAUSIBLE, dengan beberapa penghapusan penting pada data tersebut, seperti lokalitas dan kode pos.

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

Nomor jalan tidak ada

Contoh ini menunjukkan nomor jalan yang tidak ada.

Alamat dimasukkan	Wilayah
Jalan Istana Buckingham, SW1W 9TQ London	Inggris Raya

Putusan untuk nomor jalan yang tidak ada

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

validationGranularity adalah ROUTE, yang menunjukkan kecocokan dengan jalan, tetapi informasinya tidak cukup untuk mencapai premis. Selain itu, properti addressComplete tidak ada di verdict, sehingga menjadi false. Kueri lebih lanjut terhadap objek address menunjukkan jenis komponen yang tidak ada:

"missingComponentTypes": [
        "street_number"
      ]

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

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 benar-benar termasuk dalam kategori perbaikan.

Nomor jalan belum dikonfirmasi

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

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

Putusan nomor jalan yang belum dikonfirmasi

Contoh di bawah ini menekankan sinyal-sinyal penting.

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

Sebaiknya selidiki kombinasi perincian validasi hanya untuk perkiraan tingkat premis bersama dengan 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 disetel ke UNCONFIRMED_BUT_PLAUSIBLE. Belum dikonfirmasi berarti layanan tidak dapat mencocokkan nomor jalan 84 dalam set datanya, dan masuk akal berarti data komponen mungkin masih valid.

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

Subpremis tidak ada

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

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

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

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

Putusan untuk subpremis yang tidak ada

Dalam contoh ini, verdict tidak menampilkan properti addressComplete sehingga menjadi false. Karena itu, Anda tahu bahwa setidaknya satu elemen alamat tidak diharapkan, belum terselesaikan, atau hilang.

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

}

Kueri address menampilkan hal berikut:

"missingComponentTypes": [
        "subpremise"
      ]

Setelah penyelidikan lebih lanjut, data USPS memberikan kode dpvConfirmation dari D, yang juga menunjukkan subpremis yang tidak ada.

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