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

本文档介绍了一些实际应用场景,在这些场景中,地址验证 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
}