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 Membangun logika validasi untuk mengetahui konteksnya.

Contoh umum: konfirmasi

Contoh berikut mengilustrasikan kasus area metropolitan dengan nama jalan yang mirip. Misalnya, pengguna ingin memasukkan alamat untuk Google Building D di Kirkland, WA, Amerika Serikat. Namun, alih-alih Kirkland sebagai kota, mereka secara tidak sengaja memasukkan Seattle.

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

Hasil untuk data yang diganti

Contoh di bawah menekankan sinyal penting dari keputusan.

{
  "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 belum dikonfirmasi dan diganti, sehingga kombinasinya mengarahkan respons ini ke kategori konfirmasi.

Kueri komponen alamat menunjukkan area yang perlu diperhatikan 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 me-resolve ke alamat Seattle. Ini bisa menjadi pengganti yang valid, tetapi bersama dengan fakta bahwa komponen belum dikonfirmasi, sebaiknya pastikan bahwa pengguna bermaksud memasukkan alamat Seattle dan bukan alamat lain, seperti Kirkland.

Contoh kasus ekstrem: konfirmasi

Contoh berikut mengilustrasikan jenis kasus ekstrem berikut:

Inferensi kecil yang DIKONFIRMASI

Jika digabungkan dengan data yang dikonfirmasi dari 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 yang 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 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 yang memiliki nama kota yang sama, 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 telah dikonfirmasi, yang berarti komponen tersebut cocok dengan data yang disimpan oleh Address Validation API, dan layanan tersebut 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 sesuai, Address Validation API akan menghapusnya dari output. Dalam kasus ini, Anda dapat menerima alamat atau mengonfirmasinya kembali dengan pelanggan, bergantung pada tingkat risiko dan tingkat keyakinan Anda.

Misalnya, alamat mungkin berasal dari wilayah tempat pelanggan sering memasukkan informasi yang tidak berbahaya yang diabaikan oleh otoritas pos, sehingga Anda akan menerima alamat tersebut. Namun, dalam beberapa kasus, komponen yang belum dikonfirmasi mungkin bukan yang diinginkan pelanggan.

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

Keputusan 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 berformat 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 di 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 surat di Inggris Raya dan internasional.

Akibatnya, saat pelanggan memberikan county dalam alamat di Inggris Raya, layanan akan mengevaluasinya sebagai input yang tidak terduga.

Alamat yang 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 bernilai salah 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 tidak diformat dengan benar. Ingat bahwa Address Validation API juga mengevaluasi informasi untuk pemformatan yang tepat.