本文件說明多種實際情境,其中 Address Validation API 會提供回應信號,保證系統會接受行為。如需背景資訊,請參閱使用驗證回應中的工作流程總覽。
常見範例:accept
此情境說明系統會接受客戶輸入的地址。
已輸入地址 | 區域 |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ, USA | 英國 |
判定結果:可接受的地址
下例會醒目顯示重要信號。
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
除了上述資訊外,回應還會指出下列資訊:
hasUnconfirmedComponents
仍為false
hasInferredComponents
仍為false
hasReplacedComponents
仍為false
這些信號組合起來,表示地址品質優良。
特殊案例範例:接受
以下範例說明 verdict
指出需要進一步調查的品質問題。這些範例也說明了邏輯如何從判定結果傳送至地址元件,以便取得更完整的資訊,進而改善系統邏輯。
非美國境內的未經確認門牌號碼
這個範例說明輸入的義大利地址項目,其中包含所有地址元件,且沒有推論或替換的元件。不過,validationGranularity
為 ROUTE
。
已輸入地址 | 區域 |
---|---|
Via Fonte Grugnale,14 單位 2, 66054 Vasto CH, Italia | IT |
未經確認的門牌號碼判定結果
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
進一步調查地址元件後,發現街道號碼為 UNCONFIRMED_BUT_PLAUSIBLE
。
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
美國未經確認的門牌號碼
本範例說明如何輸入美國地址,其中包含所有地址元件,且沒有推測或取代的元件。不過,validationGranularity
是 PREMISE_PROXIMITY
。
已輸入地址 | 區域 |
---|---|
975 Carson Dr, Sunnyvale, CA 94086, USA | 美國 |
未確認的門牌號碼的 USPS 資料
{
"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",
}
確認地址的 USPS 資料不完整
本範例說明如何輸入美國地址,其中所有地址元件均已確認,且沒有推斷或取代的元件,validationGranularity
為 PREMISE
。不過,uspsData
並未完全填入資料,且不含 dpvConfirmation
值。
輸入的地址 | 區域 |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | 美國 |
判定結果:確認地址,但 USPS 資料不完整
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
已確認地址的 USPS 資料 (USPS 資料不完整)
{
"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"
}