Memperbaiki alamat - contoh

Dokumen ini menjelaskan sejumlah skenario dunia nyata saat Address Validation API memberikan sinyal respons yang mungkin memerlukan perilaku perbaikan dari sistem Anda. Lihat Contoh alur kerja di Buat logika validasi Anda untuk mendapatkan konteks.

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 menggambarkan entri yang hanya memiliki alamat jalan, tanpa kota atau kode pos.

Putusan untuk kota dan kode pos yang tidak ada

Contoh di bawah menekankan sinyal penting dari respons.

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

possibleNextAction memberikan indikasi awal bahwa alamat mungkin tidak dapat dituju. Komponen lain yang disoroti juga mendukung kemungkinan ini, jadi 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. API ini menampilkan semua komponen alamat lainnya sebagai UNCONFIRMED_BUT_PLAUSIBLE, dengan beberapa penghilangan penting pada data, seperti lokalitas dan kode pos.

Nomor jalan tidak ada

Contoh ini menunjukkan nomor jalan yang tidak ada.

Putusan untuk nomor jalan yang tidak ada

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

Sekali lagi, possibleNextAction memberikan indikasi awal bahwa alamat mungkin tidak dapat digunakan untuk pengiriman. Selain itu, validationGranularity adalah ROUTE, yang menunjukkan kecocokan dengan jalan, tetapi informasi tidak cukup untuk menuju ke lokasi. Selain itu, properti addressComplete tidak ada dalam putusan, sehingga nilainya adalah 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 tertentu Anda. Contoh di bawah mengilustrasikan skenario yang mungkin tidak 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.

Putusan untuk nomor jalan yang tidak dikonfirmasi

Contoh di bawah ini menekankan sinyal penting.

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

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

Sub-lokasi tidak ada

Skenario ini menggambarkan alamat yang hanya tidak memiliki sub-tempat, 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 dan oleh karena itu tidak ada saat pemeriksaan manual putusan.

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

Putusan untuk sublokasi yang tidak ada

Dalam contoh ini, putusan tidak menampilkan properti addressComplete, sehingga oleh karena itu, nilainya adalah false. Oleh karena itu, Anda tahu bahwa setidaknya ada satu elemen alamat yang tidak terduga, belum terselesaikan, atau tidak ada.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Kueri address menampilkan hal berikut:

"missingComponentTypes": [
        "subpremise"
      ]

Setelah diselidiki lebih lanjut, data USPS memberikan kode dpvConfirmation D, yang juga menunjukkan sublokasi tidak ada.