新增地址中的分區 (僅限美國)

本文說明多個實際情境,在這些情境中,Address Validation API 會提供回應信號,保證系統會執行「新增子處所」行為。這些信號僅適用於美國地址。 如需背景資訊,請參閱「建構驗證邏輯」中的「工作流程範例」。

常見範例:新增子處所

這個情境說明系統可能會提示顧客在地址中加入門牌號碼。

輸入的地址 區域
1450 Brickell Avenue, Miami, FL 33131-4065 美國

缺少子處所的地址判定結果

以下範例會醒目顯示重要信號。

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

極端案例範例:新增子處所

以下範例說明 verdict 指出地址品質問題,需要進一步調查的情況。這個範例也說明如何將邏輯從判定結果套用至地址元件,以取得更完整的資訊,進而強化系統邏輯。

缺少子建築物,以及推論和替換的元件

這個範例說明輸入美國地址時,缺少地區且郵遞區號不正確。

輸入的地址 區域
1450 Brickell Avenue, FL 33132-4065 美國

缺少子處所和推論及替換元件的判定結果

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

進一步調查地址元件後,發現系統推論出地區,並取代了郵遞區號。

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}