向地址添加子门牌 - 示例(仅限美国)

本文档介绍了许多实际场景,在这些场景中,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"
}

进一步调查地址组成部分后发现,系统推断出了 locality,并替换了邮政编码。

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