Konfirmasi alamat - contoh

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

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

Contoh umum: konfirmasi

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

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

Putusan untuk data yang diganti

Contoh di bawah ini menekankan sinyal penting dari respons.

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

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

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 Surabaya, dan mengganti kode pos, komponen tingkat yang lebih tinggi, untuk me-resolve ke alamat Surabaya. Ini bisa menjadi pengganti yang valid, tetapi bersama dengan fakta bahwa komponen tidak dikonfirmasi, sebaiknya pastikan bahwa pengguna bermaksud memasukkan alamat Seattle, bukan yang lain, seperti Kirkland.

Tips: Periksa alamat yang benar di demo, menggunakan 451 7th Avenue South, Kirkland, WA 98033 untuk melihat respons untuk alamat yang awalnya dimaksudkan.

Tindakan: Konfirmasi entri alamat dengan pelanggan.

Contoh kasus ekstrem: konfirmasi

Contoh berikut mengilustrasikan jenis kasus ekstrem berikut:

• Inferensi minor yang DIKONFIRMASI. Address Validation API menyimpulkan negara, kode pos, atau negara bagian, tetapi semua yang lain disediakan dan dikonfirmasi. Kombinasi tingkat perincian dan konfirmasi membuat inferensi minor tidak perlu memerlukan tindakan konfirmasi.
• Komponen alamat yang tidak terduga TIDAK dikonfirmasi. Komponen alamat yang belum dikonfirmasi akan ditambahkan ke tingkat risiko alamat. Hal ini mungkin memerlukan konfirmasi.
• Komponen alamat yang tidak terduga yang DIKONFIRMASI. Komponen ini tidak mutlak diperlukan untuk alamat yang tepat, dan Address Validation API akan menghapusnya dari output. Masalah pemformatan umumnya tidak memerlukan konfirmasi.

Inferensi minor yang DIKONFIRMASI

Jika digabungkan dengan data yang dikonfirmasi dari tingkat yang lebih terperinci, API masih dapat membuat inferensi yang benar jika input hanya melewatkan 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
Jl. Arjuna No. 39 RT 10/RW 05	AS

Putusan 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-negara yang menggunakan pengulangan nama kota, seperti Springfield di Amerika Serikat, komponen lain yang digabungkan dengan nama kota tersebut dapat memberikan alamat 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 bahwa 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
}

Tindakan: Terima. Alamat seperti ini memberikan tingkat perincian yang dikonfirmasi secara memadai, bersama dengan konfirmasi komponen yang disimpulkan, sehingga logika Anda dapat menerimanya sebagai valid tanpa perlu meminta pelanggan.

Komponen alamat yang tidak terduga TIDAK dikonfirmasi

Skenario ini menggambarkan pentingnya pemeriksaan 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. Dalam hal ini, Anda akan menerima alamat tersebut. Namun, dalam beberapa kasus, komponen yang belum dikonfirmasi mungkin bukan yang diinginkan pelanggan.

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

Verdict for unexpected address component not confirmed

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

Selain verdict dengan komponen yang belum dikonfirmasi, Address Validation API akan menampilkan alamat berformat berikut:

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

Pemindaian 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
}

Tindakan: Konfirmasi. Dalam hal ini, sublokalitas, yang dapat menunjukkan distrik perumahan atau lingkungan, mungkin sudah benar, tetapi masih diabaikan oleh otoritas pos. Namun, mengingat informasi ini **tidak** dikonfirmasi oleh Address Validation API, sebaiknya konfirmasikan hal ini dengan pelanggan. Pada tahap ini, Anda dapat mengabaikan penghapusan atau mengonfirmasinya.

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 badan pos Inggris Raya dan pada dasarnya diabaikan. Lihat postoffice.co.uk dan Cara menulis alamat email Inggris Raya dan internasional.

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

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

Verdict for unexpected address component that IS confirmed

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

Di sini, address_complete mengevaluasi 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
}

Komponen ini tidak terduga dan dikonfirmasi, yang berarti hal berikut:

• Dikonfirmasi sebagai data yang benar. Hal ini menunjukkan bahwa komponen adalah county yang benar yang berisi alamat.
• Tidak terduga sebagai input. Menunjukkan komponen yang tidak diperlukan untuk pemformatan alamat yang tepat.

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 benar.

Tindakan: Untuk skenario ini, tindakan yang direkomendasikan adalah mengabaikan sinyal ini dan menerima alamat.