Konfirmasi alamat - contoh

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

Contoh umum: konfirmasi

Contoh berikut menggambarkan kasus wilayah metropolitan dengan nama jalan yang serupa. Misalnya, pengguna ingin memasukkan alamat Gedung Google D di Kirkland, WA, Amerika Serikat. Namun, alih-alih Kirkland sebagai kota, mereka secara tidak sengaja memasukkan Seattle.

Alamat dimasukkan Wilayah
Building D, 451 7th Avenue South, Seattle, WA 98033 US

Keputusan untuk data yang diganti

Contoh di bawah menekankan sinyal penting dari verdict.

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

Tingkat perincian PREMISE_PROXIMITY menunjukkan perkiraan alamat tingkat bangunan, tetapi tidak sedetail SUB_PREMISE, yang merupakan perincian yang diberikan pada input. Respons juga berisi komponen yang tidak dikonfirmasi dan diganti, sehingga kombinasi ini mengkategorikannya ke dalam kategori confirm.

Kueri komponen alamat mengungkapkan area masalah berikut:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

Dalam hal ini, Address Validation API menemukan perkiraan yang mendekati alamat yang diberikan di Seattle, dan mengganti kode pos, komponen tingkat yang lebih tinggi, untuk menyelesaikan alamat Seattle. Ini bisa menjadi pengganti yang valid, tetapi bersama dengan fakta bahwa komponen tidak dikonfirmasi, sebaiknya pastikan pengguna bermaksud memasukkan alamat Seattle, bukan alamat lain, seperti Kirkland.

Contoh kasus ekstrem: konfirmasi

Contoh berikut menggambarkan jenis kasus ekstrem berikut:

Inferensi kecil yang DIKONFIRMASI

Jika digabungkan dengan data terkonfirmasi pada tingkat yang lebih terperinci, API masih dapat membuat inferensi yang benar jika input hanya kehilangan satu komponen dari jenis berikut:

  • Kota
  • Negara Bagian
  • Kode pos
  • Negara

Misalnya, pelanggan memberikan alamat jalan yang valid untuk restoran McDonald's di Springfield, Massachusetts, tetapi lupa memasukkan kota dan memberikan kode pos tanpa ekstensi 4 digit.

Alamat dimasukkan Wilayah
1402 Allen St, MA 01118 US

Keputusan untuk kota yang tidak ada

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

Dalam situasi saat Address Validation API menyimpulkan komponen tingkat yang lebih tinggi untuk menghasilkan alamat yang dapat dikirim, Anda dapat memiliki tingkat keyakinan yang lebih tinggi bahwa data dari sistem sudah benar. Hal ini karena komponen yang disimpulkan yang mewakili wilayah geografis yang luas lebih mudah dicocokkan dengan komponen alamat yang dikonfirmasi yang lebih terperinci. Bahkan di negara-negara yang nama kotanya berulang, seperti Springfield di Amerika Serikat, komponen lain yang digabungkan dengannya dapat memberikan alamat yang unik.

Dengan menggunakan contoh di atas, pemindaian di semua komponen alamat menunjukkan bahwa setiap komponen dikonfirmasi, yang berarti cocok dengan data yang disimpan oleh Address Validation API, dan layanan juga menyimpulkan dua komponen tingkat yang lebih tinggi.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

Komponen alamat yang tidak terduga TIDAK dikonfirmasi

Skenario ini menggambarkan pentingnya memeriksa kapan komponen tidak dikonfirmasi. Jika komponen alamat tidak terduga, Address Validation API akan menghapusnya dari output. Dalam kasus ini, Anda dapat menerima alamat tersebut atau mengonfirmasinya kembali dengan pelanggan, bergantung pada tingkat risiko dan tingkat keyakinan Anda.

Misalnya, alamat mungkin berasal dari wilayah tempat pelanggan sering memasukkan informasi tidak berbahaya yang diabaikan oleh otoritas pos, dalam hal ini Anda akan menerima alamat tersebut. Namun, dalam beberapa kasus, komponen yang belum dikonfirmasi mungkin tidak sesuai dengan keinginan pelanggan.

Alamat dimasukkan Wilayah
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry Prancis

Putusan untuk komponen alamat yang tidak terduga tidak dikonfirmasi

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

Selain verdict dengan komponen yang belum dikonfirmasi, Address Validation API menampilkan alamat yang diformat sebagai berikut:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

Pemindaian untuk komponen yang belum dikonfirmasi menunjukkan bahwa API menghapus la caritat 2 dari alamat yang ditampilkan:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

Komponen alamat yang tidak terduga yang DIKONFIRMASI

Contoh ini menggambarkan penyertaan county Inggris Raya dalam alamat yang diberikan, yang merupakan praktik umum. Namun, hal ini bukan persyaratan dari otoritas pos Inggris Raya dan pada dasarnya diabaikan. Lihat postoffice.co.uk dan Cara menulis alamat untuk surat di Inggris Raya dan internasional.

Akibatnya, saat pelanggan memberikan county dalam alamat Inggris Raya, layanan mengevaluasi hal ini sebagai input yang tidak terduga.

Alamat dimasukkan Wilayah
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP Inggris Raya

Keputusan untuk komponen alamat yang tidak terduga yang DIKONFIRMASI

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE"
}

Di sini, address_complete dievaluasi ke salah (false) dan analisis komponen alamat mengungkapkan tanda yang tidak terduga.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

Meskipun Gloucestershire adalah county yang benar untuk alamat yang dimasukkan, alamat itu sendiri diformat dengan tidak benar. Ingatlah bahwa Address Validation API juga mengevaluasi informasi untuk pemformatan yang tepat.