发送地址验证请求

通过向以下某个端点发出 POST 请求来发送地址验证请求：

• validateAddress (REST)
• ValidateAddress (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=API_KEY"

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

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

借助 API Explorer，您可以发出实时请求，以便熟悉 API 和 API 选项：

地址请求字段

请求正文包含一个字段：

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

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

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

请参阅参考指南中的 PostalAddress。

USPS CASS™ 选项

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

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

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

试试看！

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

1. 选择页面右侧的 API 图标 api。

2. （可选）修改请求参数。

3. 选择执行按钮。在对话框中，选择您要用于提出请求的账号。

4. 在 APIs Explorer 面板中，选择全屏图标 fullscreen 以展开 APIs Explorer 窗口。