修正地址 - 範例

本文件說明的幾種實際情境，其中 Address Validation API 提供的回應信號可由系統進行「修正」fix行為。如要瞭解相關資訊，請參閱「建構驗證邏輯」中的工作流程總覽。

常見示例：修正

本節說明 Address Validation API 提供的回應信號，指出地址資訊品質不佳。

缺少城市和郵遞區號

這個範例說明只有街道地址，而且沒有城市或郵遞區號的項目。

已輸入地址 區域
中正路 21 號 美國

缺少城市和郵遞區號的認定結果

以下範例強調回應中的重要信號。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

這些信號代表無法配送的位址，因此您可以查詢 addressComponents 以瞭解詳情：

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API 只會以 CONFIRMED 傳回國家/地區 (美國)。 它會傳回所有其他地址元件，例如 UNCONFIRMED_BUT_PLAUSIBLE，且會遺漏部分資料，例如縣市和郵遞區號。

缺少門牌號碼

以下範例顯示遺漏的門牌號碼。

已輸入地址 區域
白金漢宮路 (SW1W 9TQ London) 英國
缺少門牌號碼的認定結果
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity 為 ROUTE，表示與街道相符，但取得的地點資訊不足。此外，判定結果中缺少 addressComplete 屬性，因此該屬性為 false。進一步查詢 address 物件會顯示缺少的元件類型：

"missingComponentTypes": [
        "street_number"
      ]

極端案例：修正

在某些情況下，您要修正、確認或接受地址，取決於您的商業情境。以下範例說明未嚴格歸類到修正類別的情況。

未確認的門牌號碼

在這個情況下，Address Validation API 無法確認提供的門牌號碼，但代表地址已完成。

已輸入地址 區域
84 白金漢宮路，倫敦 SW1W 9TQ 英國

未確認門牌號碼的認定結果

以下範例強調重要信號。

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

建議您只研究驗證精細程度的組合，再結合前內部層級的近似值以及未確認的元件。addressComponents 屬性的查詢會顯示下列未確認的 componentType：

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

在這裡，street_number 的 confirmation_level 設為 UNCONFIRMED_BUT_PLAUSIBLE。「Unconfirmed」(未確認) 表示服務無法與資料集中的 84 號街道編號相符，而「plausible」則表示元件資料仍可能有效。

缺少次要場所

本情境描述的地址只是缺少次要場所，例如公寓或部門編號，否則，Address Validation API 可以完整驗證地址。就像缺少任何位址元件一樣，addressComplete 為 false，因此不會被手動檢查判定結果。

為了進行說明，假設客戶輸入了舊金山城市評估者辦公室的有效地址，但遺漏了輸入內容中的房間號碼。

已輸入地址 區域
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102, USA 美國

遺漏次要場所的判定結果

在此範例中，判定結果不會顯示 addressComplete 屬性，因此是 false。因此，您知道至少有一個地址元素不符合預期、未解析或遺失。

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

}

address 查詢會顯示下列資訊：

"missingComponentTypes": [
        "subpremise"
      ]

進一步調查後，USPS 資料會提供 D 的 dpvConfirmation 代碼，也表示缺少次要場所。