接受地址 - 範例

本文件將說明多種實際使用情況， Address Validation API 提供的回應信號會影響「接受」行為 。詳情請見 工作流程總覽： 使用驗證回應提供背景資訊。

常見範例：接受

本情境說明系統接受在 輸入地址。

已輸入地址 區域
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"
}
敬上 ，瞭解如何調查及移除這項存取權。