Dokumen ini menjelaskan sejumlah skenario dunia nyata saat Address Validation API memberikan sinyal respons yang menjamin perilaku accept dari sistem Anda. Lihat Ringkasan alur kerja di Menggunakan respons validasi untuk konteks.
Contoh umum: menerima
Skenario ini menggambarkan alamat yang akan digunakan sistem Anda untuk menerima alamat yang dimasukkan oleh pelanggan.
Alamat dimasukkan | Wilayah |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | Inggris Raya |
Putusan untuk alamat yang dapat diterima
Contoh di bawah ini menyoroti sinyal yang penting.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Selain itu, respons tersebut menunjukkan hal berikut:
hasUnconfirmedComponents
tetap menjadifalse
hasInferredComponents
tetap menjadifalse
hasReplacedComponents
tetap menjadifalse
Jika digabungkan, sinyal ini menunjukkan alamat berkualitas tinggi.
Contoh kasus ekstrem: menerima
Contoh berikut mencakup situasi saat verdict
menunjukkan masalah kualitas
alamat yang memerlukan penyelidikan lebih lanjut. Contoh ini juga
menunjukkan bagaimana logika Anda dapat berpindah dari verdict ke komponen alamat
untuk mendapatkan gambaran yang lebih lengkap guna meningkatkan logika sistem Anda.
Nomor jalan non-AS yang belum dikonfirmasi
Contoh ini mengilustrasikan entri alamat di Italia dengan semua komponen alamat
yang ada, bersama tanpa komponen yang disimpulkan atau diganti. Namun, validationGranularity
adalah ROUTE
.
Alamat dimasukkan | Wilayah |
---|---|
Melalui Fonte Grugnale, 14 unit 2, 66054 VASTo CH, Italia | IT |
Putusan untuk nomor jalan yang belum dikonfirmasi
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Penyelidikan lebih lanjut terhadap komponen alamat mengungkapkan bahwa nomor jalan adalah UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Nomor jalan AS yang belum dikonfirmasi
Contoh ini mengilustrasikan entri alamat AS dengan semua komponen alamat
yang ada, tanpa komponen yang disimpulkan atau diganti. Namun, validationGranularity
adalah PREMISE_PROXIMITY
.
Alamat dimasukkan | Wilayah |
---|---|
975 Carson Dr, Sunnyvale, CA 94086 | Amerika Serikat |
Data USPS untuk nomor jalan yang belum dikonfirmasi
{
"firstAddressLine": "975 CARSON DR",
"cityStateZipAddressLine": "SUNNYVALE CA 94086",
"city": "SUNNYVALE",
"state": "CA",
"zipCode": "94086"
"dpvConfirmation": "N",
"dpvFootnote": "AAM3",
"carrierRoute": "C031",
"carrierRouteIndicator": "D",
"postOfficeCity": "SUNNYVALE",
"postOfficeState": "CA",
"fipsCountyCode": "085",
"county": "SANTA CLARA",
}
Data USPS tidak lengkap untuk alamat yang dikonfirmasi
Contoh ini mengilustrasikan entri alamat AS dengan semua komponen alamat
yang dikonfirmasi, tanpa komponen yang disimpulkan atau diganti, dan
validationGranularity
dari PREMISE
. Namun, uspsData
tidak terisi
sepenuhnya, dan tidak berisi nilai dpvConfirmation
.
Alamat dimasukkan | Wilayah |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | Amerika Serikat |
Keputusan untuk alamat yang dikonfirmasi dengan data USPS tidak lengkap
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
Data USPS untuk alamat yang dikonfirmasi dengan data USPS tidak lengkap
{
"standardizedAddress": {
"firstAddressLine": "155 VIA CONDADO WAY",
"cityStateZipAddressLine": "PALM BEACH GARDENS",
"city": "PALM BEACH GARDENS",
"state": "FL",
"zipCode": "33418"
},
"carrierRoute": "H018",
"postOfficeCity": "PALM BEACH GARDENS",
"postOfficeState": "FL"
}