接受地址 - 範例

本文件說明在許多實際情境中，Address Validation API 會提供回應信號，這些信號應保證系統會「接受」系統的行為。如需背景資訊，請參閱「使用驗證回應」中的「工作流程總覽」一節。

常見範例：接受

此情境說明系統可接受客戶輸入的地址。

已輸入地址 區域
臺北市信義路 5 段 7 號 英國

判定可接受的地址

以下範例醒目顯示了重要信號。

{
  "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 義大利

未確認門牌號碼的裁決結果

{
  "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 美國

未確認門牌號碼的 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 資料不完整

這個範例說明，所有地址元件已確認的美國地址輸入情形，沒有推測或替換的元件，以及 PREMISE 的 validationGranularity。然而，uspsData 並未完整填入，且不含 dpvConfirmation 值。

已輸入地址 區域
信義路 5 段 155 號、佛羅裡達州 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"
}