Divisions: divisionsByAddress

查詢單一地址的政治地理區劃。立即試用

要求

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

用於識別資源的種類。

值:固定字串 "civicinfo#divisionsByAddressResponse"

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 為 ocd-division/country:us/district:dc,則清單會包含 ocd-division/country:us/state:dc

divisions.(key).name string 分類名稱。

試試看!