处理美国地址

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

工作流中的 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 可以接受邮件,但是分楼的 Ste 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.