处理美国地址

本文档介绍了特定于美国的地址验证：

• 在工作流中使用 USPS 数据
• USPS 交付点验证字段 (dpv)
• 安全消息

工作流中的 USPS 数据

验证美国境内的地址时，Address Validation API 服务还可以填充返回值的 uspsData 部分。

要点 ：如果您的系统主要或专门处理美国地址，您可以选择将此响应对象用作检查逻辑中的第一个参考点。不过，请务必注意，对于服务验证的每个地址，系统不一定会完整填充 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.

注意： 当 uspsData 指示人工地址时，Address Validation API 响应中其他属性的响应不受影响。