修正地址 - 範例

本文件將說明多種實際情境，說明 Address Validation API 提供的回應信號，可保證系統會執行修正行為。如需背景資訊，請參閱「建立驗證邏輯」一文中的工作流程總覽。

常見範例：修正

本節將說明 Address Validation API 提供回應訊號，表示地址資訊品質較低的常見範例。

缺少城市和郵遞區號

這個範例顯示只有街道地址的項目，沒有城市或郵遞區號。

輸入的地址 區域
21 45 40th street USA

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

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

{
  "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，但會省略一些重要的資料，例如地區和郵遞區號。

缺少門牌號碼

這個範例顯示缺少門牌號碼。

輸入的地址 區域
倫敦 Buckingham Palace Road，SW1W 9TQ 英國
缺少門牌號碼的判定結果
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

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

"missingComponentTypes": [
        "street_number"
      ]

極端案例範例：修正

在某些情況下，您是否要修正、確認或接受地址，取決於您的特定商務情境。以下範例說明可能不屬於修正類別的情況。

未確認的門牌號碼

在這種情況下，Address Validation API 無法確認所提供的街道號碼，但會指出地址已完整提供。

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

未經確認的街道號碼判定結果

以下範例強調了重要的信號。

{
  "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 資料會提供 dpvConfirmation 代碼 D，這也表示缺少子門牌。