本文档介绍了特定于美国的地址验证:
- 在工作流中使用 USPS 数据
- USPS 交付点验证字段 (dpv)
- 安全消息
工作流中的 USPS 数据
验证美国境内的地址时,Address Validation API 服务还可以填充返回值的 uspsData 部分。
由于系统不一定会填充此对象,因此您不应依赖此属性作为验证地址的唯一方式,而应将判定结果和地址组成部分也整合到您的系统中。
USPS 交付点验证 (DPV)
作为 uspsData
响应的一部分,dpvConfirmation
字段会返回单个字符,告知您 USPS 是否可以配送到提供的地址。
您可以使用此字段确定以下内容:
- 地址有效性。
- 如果地址中缺少子级处所编号,则会发生该错误。
- 如果 USPS 数据系统中不存在子级处所编号。
服务要么返回四个 dpvConfirmation
值中的一个,要么根本不返回 dpvConfirmation
值。下表显示了您的逻辑针对每种可能的结果应采用的推荐行为。如需详细了解此逻辑,请参阅使用验证响应中的工作流概览。
值 |
行为 |
说明 |
---|---|---|
N 或空 |
修正地址 |
该地址未经 DPV 确认。 这意味着 USPS 无法识别所输入的建筑物编号(位于所输入的街道(路线)上,因此无法递送)。 |
D |
修正地址 |
该地址仅通过 DPV 确认了主要号码,但缺少辅助号码信息。 |
南 |
确认地址 |
该地址仅通过 DPV 确认了主要号码,辅助号码信息存在但未确认。 根据 USPS 的规定,这意味着输入的楼宇编号存在于输入的路线中,但提供的楼层在该建筑物内不存在。 |
是 |
接受地址 |
该地址已通过 DPV 确认,属于主要号码和所有次要号码。 也就是说,USPS 能够完全提交该地址,包括房产编号(如果适用)。 |
本部分的其余内容讨论了使用 DPV 代码的实际场景。
DPV N 示例 - 修正地址
本例在其他有效的地址中使用并不存在的门牌号。
- 输入的地址:12 Amphitheatre Parkway, Mountain View, CA, 94043
- 区域:美国
dpvConfirmation
字段会返回:N
这是一个强烈的信号,表示此路线中不存在相应门店号码。与其他有问题的地址一样,您的系统应提示用户进行更正。
DPV D 示例 - 修正地址
此示例使用位于纽约的 Google 办事处,但不包含是地址的必要组成部分的 sub-premise。您可以使用演示中的地址(不包含子场所信息)查看相关信息。
- 输入的地址: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.