本文档介绍了美国特有的地址验证:
- 在工作流程中使用 USPS 数据
- 美国邮政服务 (USPS) 投递点验证字段 (dpv)
- 安全消息
工作流中的 USPS 数据
验证美国境内的地址时,Address Validation API 服务还可以填充返回结果的 uspsData 部分。
由于此对象并非始终会填充,因此您不应仅依靠此属性来验证地址,而应将判决和地址组件也纳入您的系统。
美国邮政服务 (USPS) 投递点验证 (DPV)
在 uspsData
响应中,dpvConfirmation
字段会返回一个字符,用于告知您 USPS 是否可以将邮件递送到所提供的地址。
您可以使用此字段来确定以下内容:
- 地址有效性。
- 地址中缺少子地址号。
- 如果子地址编号在 USPS 数据系统中不存在。
该服务会返回四个 dpvConfirmation
值中的一个,或者根本不返回 dpvConfirmation
值。下表显示了您的逻辑可能针对 5 种可能的结果采用的行为。如需详细了解此逻辑,请参阅构建验证逻辑中的工作流示例。
值 |
行为 |
说明 |
---|---|---|
N 或空 |
修正地址 |
地址未通过 DPV 确认。 这意味着 USPS 不认可所输入街道(路线)上存在的所输入营业场所编号,因此可能无法将邮件投递到该地址。 |
D |
添加子场所 |
该地址仅针对主号码进行了 DPV 确认,缺少辅助号码信息。 |
S |
确认地址 |
地址仅针对主号码进行了 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
这确认了输入中缺少子前提。若要获得 Y 的 DPV,必须在输入中包含有效的前提。例如,您可以添加有效的子营业场所 FL 4(4 楼),以获得 dpvConfirmation
值为 Y。
DPV S 示例 - 确认地址
此示例使用了建筑物内不存在的子地址编号:
- 输入的地址:1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- 区域:美国
dpvConfirmation
字段返回:S
这表示,虽然 1600 Amphitheatre Parkway 是有效地址,但子场所 Suite 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.