查詢單一地址的政治地理區劃。立即試用。
要求
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 |
該選區的專屬 Open Civic Data 識別碼 (OCD ID)。 | |
divisions.(key).alsoKnownAs[] |
list |
參照相同部門的任何其他有效 OCD ID。 由於 OCD ID 是人類可讀且可預測的,因此單一部門偶爾會有多個 ID。這些 ID 的定義是彼此等同,其中一個 ID 一律會標示為主要 ID。系統會在 OCD ID 中傳回主要 ID,並在清單中傳回任何其他同等有效的 ID。 舉例來說,如果下列部門的 OCD ID 為 |
|
divisions.(key).name |
string |
分類名稱。 |