发送地址验证请求,方法是向某个 以下端点:
- 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"]
},
}
地址请求字段
请求正文由单个字段组成:
address
- 类型为PostalAddress
的字段,其中必须包含addressLines
中至少有一个条目。
将 address
字段发送到 Address Validation API 时,您只需要
请提供一个字段:addressLines
。不过,最简单的地址请求
应包含以下子字段:
regionCode
- 推荐。这是可选字段,但如果省略, Address Validation API 会根据地址推断区域。不过,为了最好 结果,如果您知道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 选项。
选择 API 图标
, 。
(可选)展开 Show standard parameters(显示标准参数)并设置
fields
参数添加到字段 遮盖。(可选)修改请求正文。
选择执行按钮。在对话框中,选择需要 用于发出请求
在 API Explorer 面板中,选择“展开”图标,
用于展开 API Explorer 窗口。
-
Google Maps Platform 是美国的非排他性被许可人 Postal Service®。以下商标为美国所有 Postal Service®,经许可后使用:United States Postal Service®、 CASSTM、CASS CertifiedTM。↩