处理美国地址

本文档介绍了针对美国的地址验证：

• 在工作流中使用 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 的信息，提供的子地址在该建筑物内不存在。
Y	接受地址	地址通过了主地址编号和任何辅助地址编号的 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 楼）以获得 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 响应中其他属性的响应不受影响。