確認地址 - 範例

本文說明多個實際情境,在這些情境中,Address Validation API 會針對需要系統確認行為的地址提供回應信號。此處列舉的示例無法涵蓋所有情境。如需背景資訊,請參閱「建構驗證邏輯」中的「工作流程總覽」。

常見範例:確認

以下範例說明都會區街道名稱相似的情況。假設使用者想輸入 Google Building D in Kirkland, WA, United States 的地址。不過,他們不小心將城市輸入為「Seattle」,而不是「Kirkland」。

輸入的地址 區域
Building D, 451 7th Avenue South, Seattle, WA 98033 美國

取代資料的判定結果

以下範例強調了判定結果中的重要信號。

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true
}

PREMISE_PROXIMITY 精細程度等級表示建築物層級地址的近似值,但不如輸入時提供的精細程度 SUB_PREMISE 詳細。回覆也包含未確認和已替換的元件,因此組合會將其歸入「確認」類別。

查詢位址元件後,發現下列問題:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

在本例中,Address Validation API 找到與所提供地址最接近的西雅圖地址,並替換郵遞區號 (較高層級的元件),解析為西雅圖地址。這可能是有效的替代方案,但由於元件未經確認,因此應確保使用者打算輸入西雅圖地址,而非其他地址 (例如柯克蘭)。

極端案例範例:確認

以下範例說明下列極端案例類型:

  • 已確認的次要推論。Address Validation API 會推論國家/地區、郵遞區號或州/省,但其他資訊皆由使用者提供並確認。結合精細程度和確認等級,可產生不一定需要確認動作的小型推論。
  • 未確認非預期的地址元件。未確認的地址元件會提高地址的風險等級。這可能需要確認。
  • 非預期但已確認的地址元件。這個元件並非正確地址的必要元件,Address Validation API 會將其從輸出內容中移除。格式問題通常不需要確認。

已確認的次要推論

如果輸入資料只缺少下列其中一種元件,API 仍可結合更精細的確認資料,做出正確推論:

  • 城市
  • 州
  • 郵遞區號
  • 國家/地區

舉例來說,客戶提供麻薩諸塞州春田市麥當勞餐廳的有效街道地址,但忘記輸入城市,且提供的郵遞區號不含 4 位數擴充碼。

輸入的地址 區域
1402 Allen St, MA 01118 美國

缺少城市資訊的裁決

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

如果 Address Validation API 推論出較高層級的元件,以產生可送達的地址,您就能更確信系統提供的資料正確無誤。這是因為代表廣大地理區域的推論元件,更容易與更精細的確認地址元件相符。即使在城市名稱重複的國家/地區 (例如美國的 Springfield),其他元件與城市名稱結合後,仍可提供不重複的地址。

以上述範例來說,掃描所有地址元件後,系統會確認每個元件都與 Address Validation API 儲存的資料儲存庫相符,並推論出兩個更高層級的元件。

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

未確認非預期的地址元件

這個情境說明瞭在元件「未」確認時進行檢查的重要性。如果地址元件不符合預期,Address Validation API 會將其從輸出內容中移除。在這些情況下,您可以根據風險等級和信心水準,接受地址或與客戶重新確認。

舉例來說,如果地址來自某個區域,而該區域的顧客經常輸入郵政機關忽略的無害資訊,則您會接受該地址。不過,在某些情況下,未確認的元件可能不是客戶想要的。

輸入的地址 區域
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry 法國

未確認非預期地址元件的判定結果

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

除了含有未確認元件的判定結果外,Address Validation API 還會傳回下列格式化地址:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

掃描未確認的元件後,發現 API 已從傳回的地址中移除 la caritat 2:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

非預期的地址元件,但「已」確認

這個範例說明在提供的地址中加入英國郡縣,這是常見的做法。不過,英國郵政主管機關並未要求提供這項資訊,基本上會忽略。請參閱 postoffice.co.uk 和如何填寫英國和國際郵件地址。

因此,當顧客在英國地址中提供郡時,服務會將其視為非預期輸入內容。

輸入的地址 區域
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP 英國

已確認的非預期地址元件判定結果

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

此時,address_complete 的評估結果為 false,且位址元件的分析結果顯示非預期的標記。

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

雖然格洛斯特郡是輸入地址的正確郡,但地址本身的格式不正確。請注意,Address Validation API 也會評估資訊格式是否正確。