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

Contoh umum: konfirmasi

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

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

Verdict untuk data yang diganti

Contoh di bawah menekankan sinyal penting dari the verdict.

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

Tingkat detail PREMISE_PROXIMITY granularity menunjukkan aproksimasi alamat tingkat bangunan, tetapi tidak sedetail SUB_PREMISE, yang merupakan detail yang diberikan pada input. Respons juga berisi komponen yang belum dikonfirmasi dan diganti, sehingga kombinasi ini masuk ke kategori konfirmasi.

Kueri komponen alamat mengungkapkan area perhatian 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 aproksimasi yang dekat dengan alamat yang diberikan di Seattle, dan mengganti kode pos, komponen tingkat yang lebih tinggi, untuk diselesaikan ke alamat Seattle. Ini bisa menjadi penggantian yang valid, tetapi bersama dengan fakta bahwa komponen belum dikonfirmasi, sebaiknya pastikan bahwa pengguna ingin memasukkan alamat Seattle dan bukan yang lain, seperti Kirkland.

Contoh kasus ekstrem: konfirmasi

Contoh berikut mengilustrasikan jenis kasus ekstrem berikut:

Inferensi kecil yang DIKONFIRMASI

Jika digabungkan dengan data yang dikonfirmasi pada tingkat yang lebih detail, 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 AS

Verdict 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 detail. Bahkan di negara tempat nama kota diulang, 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 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 mengilustrasikan 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 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, sehingga Anda akan menerima alamat tersebut. Namun, dalam beberapa kasus, komponen yang tidak dikonfirmasi mungkin bukan yang diinginkan pelanggan.

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

Verdict untuk komponen alamat yang tidak terduga tidak dikonfirmasi

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

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

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

Pemindaian untuk komponen yang tidak 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 mengilustrasikan 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 mengalamatkan surat Inggris Raya dan internasional.

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

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

Verdict untuk komponen alamat yang tidak terduga yang DIKONFIRMASI

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

Di sini, address_complete dievaluasi sebagai salah (false) dan analisis komponen alamat mengungkapkan flag 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.