处理美国地址

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

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

工作流中的 USPS 数据

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

要点：如果您的系统主要或专门处理美国地址，您可以选择在检查逻辑中将此响应对象用作第一个参考点。不过，请务必注意，对于服务验证的每个地址，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 是一个可以接收邮件的地址，但子门牌 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 响应中其他房源的响应不会受到影响。