Dokumen ini menjelaskan sejumlah skenario dunia nyata saat Address Validation API memberikan sinyal respons yang menjamin perilaku penerimaan dari sistem Anda. Lihat Ringkasan alur kerja di Menggunakan respons validasi untuk konteks.
Contoh umum: terima
Skenario ini menggambarkan alamat yang memungkinkan sistem Anda menerima alamat yang dimasukkan oleh pelanggan.
Alamat dimasukkan | Wilayah |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | Inggris Raya |
Putusan alamat yang dapat diterima
Contoh di bawah ini menyoroti sinyal-sinyal penting.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Selain itu, responsnya menunjukkan hal berikut:
hasUnconfirmedComponents
tetap menjadifalse
hasInferredComponents
tetap menjadifalse
hasReplacedComponents
tetap menjadifalse
Ketika digabungkan, sinyal-sinyal ini menunjukkan alamat berkualitas tinggi.
Contoh kasus ekstrem: terima
Contoh berikut mencakup situasi saat verdict
menunjukkan penanganan
masalah kualitas yang memerlukan penyelidikan lebih lanjut. Contoh-contoh ini juga
menunjukkan bagaimana logika dapat berpindah dari verdict ke komponen alamat
untuk mendapatkan gambaran yang lebih lengkap guna meningkatkan logika sistem Anda.
Nomor jalan yang belum dikonfirmasi di luar AS
Contoh ini mengilustrasikan entri alamat Italia dengan semua komponen alamat
ada, 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 ada, tanpa komponen yang disimpulkan atau diganti. Namun, validationGranularity
adalah PREMISE_PROXIMITY
.
Alamat dimasukkan | Wilayah |
---|---|
975 Carson Dr, Sunnyvale, CA 94086 | ID |
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
dikonfirmasi, tanpa komponen yang disimpulkan atau diganti, dan
validationGranularity
dari PREMISE
. Namun, uspsData
tidak terisi penuh, dan tidak berisi nilai dpvConfirmation
.
Alamat dimasukkan | Wilayah |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | ID |
Putusan alamat yang dikonfirmasi dengan data USPS yang tidak lengkap
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
Data USPS untuk alamat yang dikonfirmasi dengan data USPS yang 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"
}