发送地址验证请求

向以下端点之一发出 POST 请求，即可发送地址验证请求：

• validateAddress (REST)
• VerifyAddress (gRPC)

注意 ：本文档使用 REST 作为示例，但方法与 gRPC 类似。

您的请求还应将 JSON 请求正文传递给定义要验证的地址的请求。以下请求正文包含一个字段和三个子字段：

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY"

您还可以省略 locality，并将其指定为 addressLines 数组中的元素：

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

地址请求字段

请求正文包含一个字段：

• address - 类型为 PostalAddress 的字段，该字段必须至少在 addressLines 中包含一个条目。

将 address 字段发送到 Address Validation API 时，您只需提供一个字段：addressLines。不过，最简单的地址请求应包含以下子字段：

• regionCode - 推荐。这是可选字段，但如果省略，Address Validation API 会根据地址推断区域。不过，为了获得最佳结果，请添加 regionCode（如果您知道）。如需查看支持的区域的列表，请参阅支持的区域。
• addressLines - 必需。一个由地址构成的数组，用于描述地址的较低结构。

请参阅参考指南中的 PostalAddress。

USPS CASSTM 选项

美国邮政服务® (USPS®)¹ 维护着编码准确性支持系统 (CASSTM)，以支持和认证地址验证提供商。

注意 ：Address Validation API 已确认为 CASS-CertifiedTM 服务。这意味着服务已得到确认，能够填充缺失的地址信息、对其进行标准化，以及将其更新为最新且准确的地址。

仅对于美国和波多黎各的区域，您可以通过在请求正文中将 enableUspsCass 设置为 true 来启用 CASS 处理。为了在使用 CASS 时获得最佳效果，请提供包含门牌号和门牌号以及城市、州和邮政编码的地址：

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

注意： 如果您不需要 CASS 处理，或者如果您要验证美国和波多黎各地区以外的地址，Google 不建议您启用此功能。

---

1. Google Maps Platform 是美国邮政服务® 的非独家许可人。以下商标归美国邮政服务®所有，并经许可使用：美国邮政服务®、CASSTM、CASS 认证合作伙伴。方便