本文档介绍了特定于美国的地址验证:
- 在工作流程中使用 USPS 数据
- USPS 投递点验证字段 (dpv)
- 安全消息
工作流程中的 USPS 数据
验证美国境内的地址时,Address Validation API 服务还可以填充退货的 uspsData 部分。
由于此对象并非始终填充,因此您不应依赖此属性作为验证地址的唯一方式,而应将认定结果和地址组成部分纳入您的系统中。
USPS 投递点验证 (DPV)
在 uspsData
响应中,dpvConfirmation
字段会返回一个字符,告知您 USPS 能否投递到所提供的地址。
您可以使用此字段确定以下内容:
- 地址有效性。
- 如果地址中缺少次级场所编号,
- 如果 USPS 数据系统中不存在次级场所编号,
服务会返回四个 dpvConfirmation
值中的一个,或者根本不返回 dpvConfirmation
值。下表显示了您的逻辑应对 5 种可能结果中的每种可能采用的建议行为。如需详细了解此逻辑,请参阅使用验证响应中的工作流概览。
值 |
行为 |
说明 |
---|---|---|
N 或为空 |
修正地址 |
该地址未经 DPV 确认。 也就是说,USPS 无法识别所输入的街道(路线)上已存在的所输入的楼宇编号,因此无法送达该处。 |
D |
修正地址 |
该地址只是针对主号码进行了 DPV 确认,而辅助号码信息缺失。 |
南 |
确认地址 |
该地址仅对主号码进行了 DPV 确认,辅助号码信息存在但未经确认。 也就是说,根据 USPS 的规定,所输入的门店编号存在于所输入的道路上,但所提供的分区编号并不存在于该建筑物内。 |
是 |
接受地址 |
该地址已通过 DPV 确认,适用于主号码和任何辅助号码。 也就是说,USPS 能够完全递送该地址,包括分区编号(如果适用)。 |
本节的其余部分讨论使用 DPV 代码的实际场景。
DPV N 示例 - 修正地址
此示例针对其他有效的地址使用了不存在的门牌号。
- 输入的地址:12 Amphitheatre Parkway, Mountain View, CA, 94043
- 区域:美国
dpvConfirmation
字段会返回:N
这是一个极为强烈的信号,表明该路线上不存在相应前提编号。与其他有问题的地址一样,您的系统应该提示用户进行更正。
DPV D 示例 - 修正地址
此示例使用位于纽约的 Google 办事处,但不包含该地址的必要部分。您可以通过不带本地信息的演示中的地址来查看此信息。
- 输入的地址:111 8th Avenue, New York, NY, 10011
- 区域:美国
dpvConfirmation
字段会返回:D
这可以确认输入中缺少子场所。如需使 DPV 为 Y,必须在输入中包含有效的子部署。例如,您可以添加 FL 4(4 楼)的有效子场所,以获得 dpvConfirmation
值 Y。
DPV S 示例 - 确认地址
本示例使用了一个建筑物内不存在的楼层编号:
- 输入的地址:1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- 区域:美国
dpvConfirmation
字段会返回:S
这表明,虽然 1600 Amphitheatre Parkway 的地址可以接受邮件,但本地 Ste 101 不是该地址的有效部分。您的系统应向用户确认此信息,并提供更正机会。
DPV Y 示例 - 接受地址
此示例使用加利福尼亚州山景城的 Googleplex 地址作为已知的优质地址。
- 输入的地址:1600 Amphitheatre Parkway, Mountain View, CA, 94043
- 区域:美国
dpvConfirmation
字段会返回:Y
此地址可由 USPS 完全送达。这样一来,您可以非常确信 API 返回的地址质量较高,并且您可以按原样使用该地址。
注意:DPV 不会指示 Address Validation API 是否对输入进行了任何更改,例如拼写更正。
针对美国地址的安全邮件
本部分介绍了 USPS 数据中为人为创建的地址提供的安全标志。这项安全措施旨在通过检测提交的地址何时可能是人为构建或不是以合法方式获取的,从而防止人为创建地址列表。 这种情况应该极少发生。
当 USPS 标识出人为创建的地址时,响应的 uspsData 属性的 errorMessage
字段会包含一条错误消息,错误消息描述了相应问题。例如:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.