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