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

本文档介绍了一些真实场景,其中 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
}