向以下端点之一发出 POST 请求,即可发送地址验证请求:
- validateAddress (REST)
- VerifyAddress (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®)1 维护着编码准确性支持系统 (CASSTM),以支持和认证地址验证提供商。
仅对于美国和波多黎各的区域,您可以通过在请求正文中将 enableUspsCass
设置为 true
来启用 CASS 处理。为了在使用 CASS 时获得最佳效果,请提供包含门牌号和门牌号以及城市、州和邮政编码的地址:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
-
Google Maps Platform 是美国邮政服务® 的非独家许可人。以下商标归美国邮政服务®所有,并经许可使用:美国邮政服务®、CASSTM、CASS 认证合作伙伴。方便