处理美国地址

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

工作流中的 USPS 数据

在验证美国境内的地址时，Address Validation API 服务还可以填充返回的 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 办公室，但不包含是地址的必要组成部分的 sub-premise。您可以使用演示中的地址（不含子媒体资源信息）来查看这一点。

  • 输入的地址：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.