处理美国地址

本文档介绍了美国特有的地址验证:

工作流中的 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.