处理美国地址

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

工作流中的 USPS 数据

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

由于该对象不一定会填充，因此您不应依赖它 属性作为验证地址的唯一方式，而是将 并将判定和处理组件写入您的系统。

USPS 交付点验证 (DPV)

在 uspsData 响应中，dpvConfirmation 字段会返回单个 字符，告知您 USPS 是否可以配送到所提供的地址。

您可以使用此字段确定以下内容：

  • 地址有效性。
  • 如果地址中缺少子级处所编号，则会发生该错误。
  • 如果 USPS 数据系统中不存在子级处所编号。

服务要么返回四个 dpvConfirmation 值中的一个，要么不返回 返回 dpvConfirmation 值。下表显示了 看看你的逻辑应该针对 5 种可能的结果采用什么样的行为。有关 请参阅 使用验证响应中的工作流概览。

值

行为

说明

N 或空

修正地址

该地址未经 DPV 确认。

这意味着 USPS 无法识别您输入的楼宇编号 现有街道（路线）且无法交付到该街道。

D

修正地址

该地址是 DPV 仅确认的主要号码， 辅助号码信息缺失。

这意味着，它需要 输入的街道上存在所输入的门牌号，但要覆盖完整的 已验证/可送达地址，也必须提供有效的分店号码 。换言之，输入中缺少了子级房产。

S

确认地址

该地址是 DPV 仅确认的主要号码， 辅助号码信息存在，但尚未确认。

也就是说，输入的路线上存在所输入的建筑物编号， 但根据 美国邮政。

是

接受地址

该地址已通过 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 则输入中必须包含有效的小楼宇。例如： 您可以添加一个FL 4（4 楼）的有效分置房屋，以获取 Y 的 dpvConfirmation 值。

DPV S 示例 - 确认地址

下例使用的楼宇中并不存在子楼牌号码：

  • 输入的地址：1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • 区域：美国
  • dpvConfirmation 字段会返回：S

这说明，虽然 1600 Amphitheatre Parkway 可以接受邮件，但是分馆级“St 101”不是地址的有效部分。 您的系统应向用户确认此信息，并提供 修正机会。

DPV Y 示例 - 接受地址

本例将位于加利福尼亚州山景城的 Googleplex 地址用作 已知质量的地址。

  • 输入的地址：1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • 区域：美国
  • dpvConfirmation 字段会返回：Y

此地址完全由 USPS 送达。这样你就能在很大程度上 确信该 API 返回了高质量地址，您可以用它来 按原样。

注意：DPV 不会指明 Address Validation API 是否执行了任何操作 更改输入内容，例如拼写更正。

发送给美国地址的安全消息

本部分介绍了在针对 人为创建的地址此安全措施旨在防止 通过检测用户何时提交了地址来人为创建地址列表 似乎是人为建造的，不是通过合法途径获得的。 这种情况很少见。

当 USPS 识别到人为创建的地址时，errorMessage （位于响应的 uspsData 属性中）字段包含一个 错误消息。例如：

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.