本頁面由 Cloud Translation API 翻譯而成。

Representatives

這個集合包含政治地理位置和民選官員等資訊。

如需本資源的方法清單，請見本頁結尾。

資源表示法

這個集合中的資源分為三個部分，詳見下文。「divisions」部分會列出政治行政區，例如國家/地區、州、郡或立法選區。(清單中列出的部門會因發出的特定 API 要求而異)。「offices」部分會列出在第一部分選為代表分支的政治立場。「officials」部分會列出目前在所列辦公室提供服務的人員。

{
  "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
        }
      ]
    }
  ]
}

政治地理位置

屬性名稱	值	說明
`divisions`	`object`	包含所要求地址的政治地理區域。
`divisions.(key)`	`nested object`	這個部門的專屬 Open Civic Data ID。
`divisions.(key).alsoKnownAs[]`	`list`	參照相同部門的任何其他有效 OCD ID。由於 OCD ID 是人類可讀的格式，而且至少要有一些可以預測的 ID，因此單一部門偶爾會有多個 ID。這些 ID 的定義是彼此相等，而且一律會標示為主要 ID。主要 ID 將會在上述的 ocd_id 中傳回，這份清單中也會傳回其他對等的有效 ID。舉例來說，如果這個部門的 OCD ID 為 ocd-division/country:us/district:dc，這個欄位就會含有 ocd-division/country:us/state:dc。
`divisions.(key).name`	`string`	除名。
`divisions.(key).officeIndices[]`	`list`	`offices` 陣列中的索引清單，每個由此部門選出的辦公室各有一個索引。只有在要求中 `includeOffices` 為 true (或不存在) 時才會顯示。

選務所

屬性名稱	值	說明
`offices[]`	`list`	上述部門提及的民間辦公室。只有在要求中包含 includeOffices 為 true 時才會顯示。
`offices[].divisionId`	`string`	與此辦公室相關的部門的 OCD ID。
`offices[].levels[]`	`list`	此辦公室所屬政府的等級。單一管轄區在兩個不同等級的政府層級有效行動時可能會遇到多個情況；舉例來說，哥倫比亞特區市長在「縣市」工作但也有效影響 `administrativeArea2` 和 `administrativeArea1`。有效的值包括： `international` -- 國際政府，例如聯合國或歐盟。 `country` -- 國家級政府，例如美國聯邦政府。 `administrativeArea1`：國家/地區頂層行政部門 (例如美國各州) 的政府。 `regional` -- 管轄地可能跨越標準行政區機關的區域政府；這些情況在美國境內罕見，但卻常見於其他國家/地區的大城市。 `administrativeArea2`：國家/地區第二級行政區的政府，例如美國郡政府。 `locality`：城市或市政府。 `subLocality1`：城市頂層行政單位的政府，例如華盛頓哥倫比亞特區的行政區。 `subLocality2`：城市第二級行政區的政府，例如華盛頓特區的顧問社區委員會。 `special` -- 僅供特殊用途政府使用的當地區域，例如土壤和水資源保育區。
`offices[].name`	`string`	人類可讀的辦公室名稱。
`offices[].officialIndices[]`	`list`	該辦公室目前所有員工的官方索引清單。
`offices[].roles[]`	`list`	此辦公室負責的工作工作角色的目的並非詳盡或確切指出特定辦公室的所有職責，但主要用途是粗略，方便您從眾多辦公室中選擇或整理一連串的辦公室。有效值包括： `headOfState` - 政府的主要公開代表。國家/地區領導人通常稱為總統。 `headOfGovernment`：政府執行長。在美國，這是指總統；也通常是總理在層級較低的位置，這可能是州長或市長。 `deputyHeadOfGovernment`：對於現任民選領導人死亡或無出席之情事，負責承擔政府首席的官員。在美國，是美國副總統。這個辦公室可能還有其他職責。 `governmentOfficer`：民選董事長官。在美國各州，這類資訊可能包括律師一般、分支機構、秘書或州/儲蓄保險人等。 `executiveCouncil` - 負責以團隊身分執行高階主管職務的行政委員會成員。例如印第安納郡的委員。 `legislatorUpperBody` - 雙相機法案上半身的成員，或是單鏡頭立法規則的唯一主體。 `legislatorLowerBody` - 雙相機法部門下半身的成員。 `highestCourtJudge`：特定政府最高法院的法官，例如州最高法院。 `judge` -- 法官在任何非政府管轄法院的法院擔任法官。 `schoolBoard` - 地方學校董事會成員。 `specialPurposeOfficer`：致力於達成單一定義目的的警官，例如土壤和水資源保育委員會的成員，或是蚊子打擊警員。
`offices[].sources[]`	`list`	此辦公室的資訊來源清單。如果列出多個來源，表示資料匯總自這些來源。
`offices[].sources[].name`	`string`	資料來源的名稱。
`offices[].sources[].official`	`boolean`	這項資料是否來自政府官方來源。

民選官員

屬性名稱	值	說明
`officials[]`	`list`	擁有上述辦公室的官員。只有在要求中包含 includeOffices 為 true 時才會顯示。
`officials[].address[]`	`list`	與主管機關聯絡的地址。
`officials[].address[].city`	`string`	地址的鄉鎮或鄉鎮。
`officials[].address[].line1`	`string`	這個地址的街道名稱和門牌號碼。
`officials[].address[].line2`	`string`	視需要在第二行地址。
`officials[].address[].line3`	`string`	地址的第三行 (如有需要)。
`officials[].address[].locationName`	`string`	地點的名稱。
`officials[].address[].state`	`string`	地址的美國雙字母州縮寫。
`officials[].address[].zip`	`string`	地址的美國郵遞區號。
`officials[].channels[]`	`list`	這位官員的已知 (社群媒體) 媒體管道清單。
`officials[].channels[].id`	`string`	候選人頻道的專屬公開 ID。
`officials[].channels[].type`	`string`	頻道的類型。以下列舉幾種頻道類型，日後可能會新增更多頻道類型。以下其中之一：YouTube、Facebook、Twitter
`officials[].emails[]`	`list`	該官員的直接電子郵件地址。
`officials[].name`	`string`	官方名稱。
`officials[].party`	`string`	官方當事人所屬單位的全名。
`officials[].phones[]`	`list`	官員的公開聯絡電話號碼。
`officials[].photoUrl`	`string`	官方相片的網址。
`officials[].urls[]`	`list`	官方的公開網站網址。

方法

representativeInfoByAddress: 查詢政治地理位置和單一地址的代表資訊。
representativeInfoByDivision: 查詢單一地理區域的代表性資訊。