Representatives: representativeInfoByAddress

查詢單一地址的政治地理位置和代表資訊。 立即試用。

要求

HTTP 要求

GET https://www.googleapis.com/civicinfo/v2/representatives

參數

參數名稱 值 說明
選用的查詢參數
address string 要查詢的地址。只有在 ocdId 欄位未指定的情況下，才能指定 所提供的資訊
includeOffices boolean 指出是否要傳回辦公室和官員的相關資訊。如果是 false，則只能使用 系統將傳回頂層行政區資訊。 (預設值：true)
levels string 列出篩選依據的辦公室層級。僅允許至少提供服務的辦公室 系統就會傳回其中一個等級。不含 符合條件的辦公室將不予退還。

可接受的值為：
  • 「administrativeArea1」
  • 「administrativeArea2」
  • 「country」
  • 「international」
  • 「locality」
  • 「regional」
  • 「special」
  • 「subLocality1」
  • 「subLocality2」
roles string 列出做為篩選依據的 Office 角色清單。只有符合下列條件的辦公室： 系統就會傳回這些角色不含相符項目的部門 辦公室。

可接受的值為：
  • 「deputyHeadOfGovernment」
  • 「executiveCouncil」
  • 「governmentOfficer」
  • 「headOfGovernment」
  • 「headOfState」
  • 「highestCourtJudge」
  • 「judge」
  • 「legislatorLowerBody」
  • 「legislatorUpperBody」
  • 「schoolBoard」
  • 「specialPurposeOfficer」

要求主體

請勿使用這個方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "civicinfo#representativeInfoResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}
屬性名稱 值 說明 附註
kind string 標示資源的種類。值：固定字串 "civicinfo#representativeInfoResponse"。
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 包含要求內容的政治地理部門 讓我們看看 DNS 解析 進一步探索內部和外部位址詳情請參閱 Google 代表 資源說明文件。
offices[] list 上述部門提及的民間辦公室。威爾 。詳情請參閱 Google 代表 資源說明文件。
officials[] list 擁有上述辦公室的官員。只會出現 如果 includeOffices 屬實。詳情請參閱 Google 代表 資源說明文件。

試試看！