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.