发送地址验证请求

发送地址验证请求,方法是向某个 以下端点:

您的请求还应将 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 字段发送到 Address Validation API 时,您只需要 请提供一个字段:addressLines。不过,最简单的地址请求 应包含以下子字段:

  • regionCode - 推荐。这是可选字段,但如果省略, Address Validation API 会根据地址推断区域。不过,为获得最佳结果,请在知道 regionCode 的情况下添加 regionCode。如需查看支持的区域列表,请参阅支持的区域
  • addressLines - 必需。包含描述下层地址的地址的数组 地址的结构。
请参阅参考指南中的 PostalAddress

USPS CASSTM 选项

United States Postal Service® (USPS®)1 维护 编码准确性支持系统 (CASSTM),用于支持和认证 地址验证提供程序。

仅适用于美国和波多黎各地区,您可以通过设置 将 enableUspsCass 设置为 true。为了在使用 CASS,请提供包含街道和门牌号以及 城市、州/省/自治区/直辖市和邮政编码:

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

试试看!

借助 API Explorer,您可以发出示例请求, 您可以熟悉 API 和 API 选项。

  1. 选择 API 图标 展开 API Explorer。, 。

  2. (可选)展开显示标准参数,然后将 fields 参数设置为字段掩码

  3. (可选)修改请求正文

  4. 选择执行按钮。在对话框中,选择需要 用于发出请求

  5. 在 API Explorer 面板中,选择“展开”图标, 展开 API Explorer。 用于展开 API Explorer 窗口。


  1. Google Maps Platform 是美国的非排他性被许可人 Postal Service®。以下商标为美国所有 Postal Service®,经许可后使用:United States Postal Service®、 CASSTM、CASS CertifiedTM。