查询单个地址的政治地理划分。 立即试用。
请求
HTTP 请求
GET https://www.googleapis.com/civicinfo/v2/divisionsByAddress
参数
参数名称 | 值 | 说明 |
---|---|---|
可选的查询参数 | ||
address |
string |
要查找的地址。 |
请求正文
使用此方法时请勿提供请求正文。
响应
如果成功,此方法将返回采用以下结构的响应正文:
{ "kind": "civicinfo#divisionsByAddressResponse", "normalizedInput": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string, }, "divisions": { key: { "name": string, "alsoKnownAs": [ string ], }, }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
kind |
string |
标识资源类型。 值:固定字符串 |
|
normalizedInput |
nested object |
请求的地址的规范化版本。 | |
normalizedInput.locationName |
string |
位置的名称。 | |
normalizedInput.line1 |
string |
地址的街道名称和门牌号。 | |
normalizedInput.line2 |
string |
地址的第二行(如果有)。 | |
normalizedInput.line3 |
string |
地址的第三行(如果需要)。 | |
normalizedInput.city |
string |
地址所在的城市或镇。 | |
normalizedInput.state |
string |
地址所在的美国州的双字母缩写。 | |
normalizedInput.zip |
string |
地址的美国邮政编码。 | |
divisions |
object |
包含所请求地址的政治地理划分。 | |
divisions.(key) |
nested object |
该部门的唯一开放式民政数据标识符 (OCD ID)。 | |
divisions.(key).alsoKnownAs[] |
list |
指向同一部门的任何其他有效 OCD ID。 由于 OCD ID 可供人阅读且具有可预测性,因此单个部门有时会有多个标识符。这些标识符被定义为等同,其中一个始终被标记为主标识符。主标识符会在 OCD ID 中返回,任何其他等效的有效标识符会在列表中返回。 例如,如果以下部门的 OCD ID 为 |
|
divisions.(key).name |
string |
部门的名称。 |