Konfirmasi alamat - contoh

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

Contoh umum: mengonfirmasi

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

Alamat dimasukkan Wilayah
Gedung D, 451 7th Avenue South, Seattle, WA 98033 Amerika Serikat

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 proxy dari alamat tingkat gedung, tetapi tidak sedetail SUB_PREMISE, yang merupakan perincian yang diberikan pada input. Respons juga berisi komponen yang belum dikonfirmasi dan sudah diganti, sehingga kombinasi akan memasukkan ini ke dalam kategori confirm.

Kueri komponen alamat mengungkapkan hal-hal 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 menggantikan kode pos, yakni komponen dengan tingkat yang lebih tinggi, untuk di-resolve ke alamat Seattle. Ini dapat menjadi pengganti yang valid, tetapi meskipun komponennya belum dikonfirmasi, sebaiknya pastikan bahwa pengguna bermaksud memasukkan alamat di Seattle, bukan alamat yang lain, seperti Kirkland.

Contoh kasus ekstrem: konfirmasi

Contoh berikut menggambarkan jenis kasus ekstrem berikut:

  • Inferensi kecil yang dikonfirmasi. Address Validation API menyimpulkan negara, kode pos, atau negara bagian, tetapi semua hal lainnya sudah 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. Tindakan ini mungkin memerlukan konfirmasi.
  • Komponen alamat yang tidak terduga yang dikonfirmasi. Komponen ini tidak sepenuhnya diperlukan untuk alamat yang tepat, dan Address Validation API akan menghapusnya dari output. Masalah pemformatan umumnya tidak menandakan konfirmasi.

Inferensi kecil yang dikonfirmasi

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

  • Kota
  • Negara Bagian
  • Kode Pos
  • Negara

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

Alamat dimasukkan Wilayah
Jl. Arjuna No. 39 RT 10/RW 05 Amerika Serikat

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 pengiriman, 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 akan 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 telah dikonfirmasi, yang berarti komponen tersebut cocok dengan data yang disimpan oleh Address Validation API, dan layanan juga menyimpulkan dua komponen dengan 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 diharapkan TIDAK dikonfirmasi

Skenario ini menggambarkan pentingnya pemeriksaan kapan komponen tidak dikonfirmasi. Jika komponen alamat tidak diharapkan, Address Validation API akan menghapusnya dari output. Dalam kasus ini, Anda dapat menerima alamat tersebut atau mengonfirmasi ulang dengan pelanggan, bergantung pada tingkat risiko dan tingkat kepercayaan 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 komponen yang diinginkan pelanggan.

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

Putusan untuk komponen alamat yang tidak terduga belum dikonfirmasi

{
  "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 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 tidak terduga yang dikonfirmasi

Contoh ini mengilustrasikan penyertaan wilayah Inggris Raya di alamat yang diberikan, yang merupakan praktik umum. Namun, hal ini bukan persyaratan oleh otoritas pos Inggris Raya dan pada dasarnya diabaikan. Lihat postoffice.co.uk dan Cara menghubungi email Inggris Raya dan internasional.

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

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

Keputusan untuk komponen alamat tidak terduga yang telah dikonfirmasi

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

Di sini, address_complete bernilai 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 daerah 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.