接受地址 - 範例

本文說明多種實際情況，在這些情況下，地址驗證 API 會提供回應信號，讓您的系統接受地址。如需相關背景資訊，請參閱「使用驗證回應」中的「工作流程總覽」。

常見範例：接受

這個情境說明系統接受顧客輸入地址的地址。

輸入的地址 區域
76 Buckingham Palace Road, London SW1W 9TQ 英國

可接受地址的判決結果

下例會標示重要信號。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

此外，verdict 代表：

  • hasUnconfirmedComponents 仍為 false
  • hasInferredComponents 仍為 false
  • hasReplacedComponents 仍為 false

綜合來看，這些信號代表地址品質良好。

極端案例範例：接受

以下範例涵蓋 verdict 指出地址品質問題，需要進一步調查的情況。這些範例也說明邏輯如何從判決結果傳遞至地址元件，以取得更完整的資訊，進而強化系統邏輯。

美國以外地區未確認的門牌號碼

這個範例說明如何輸入義大利地址，其中包含所有地址元件，且沒有推斷或取代的元件。不過，validationGranularity 是 ROUTE。

輸入的地址 區域
Via Fonte Grugnale, 14 unit 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 美國

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"
}