本文档介绍了特定于美国的地址验证:
- 在工作流程中使用 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 纽约办事处,但并不包含下级场所(该地址的必要部分)。您可以通过使用不含子场所信息的演示中的地址来查看此信息。
- 输入的地址:111 8th Avenue, New York, NY, 10011
- 区域:美国
dpvConfirmation
字段会返回:D
这可以确认输入的内容中没有子场所。若要使 DPV 为 Y,必须在输入中包含有效的子部署。例如,您可以添加 FL 4(4 楼)的有效子场所,以获取 Y 的 dpvConfirmation
值。
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.