发送地址验证请求

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

您的请求还应将 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=API_KEY"

您还可以省略 locality,并在 addressLines 数组中将其指定为元素:

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

地址请求字段

请求正文包含一个字段:

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

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

  • regionCode - 推荐。此字段为可选字段,但如果省略,Address Validation API 会根据地址推断区域。不过,为了获得最佳结果,请包含 regionCode(如果您知道的话)。如需查看支持的区域的列表,请参阅支持的区域
  • addressLines - 必需。包含描述地址较低结构的地址的数组。
请参阅参考指南中的 PostalAddress

USPS CASSTM 选项

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

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

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

  1. Google Maps Platform 是美国邮政服务® 的非独家被许可人。以下商标归美国邮政服务® 所有,经许可后使用:美国邮政服务®、CASSTM、CASS CertifiedTM。