本頁面由 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。上方的 ocd_id 會傳回主要 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` -- 城市第二層行政區的政府，例如華盛頓特區 (DC's Advisory Neighborhood Councils)。 `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: 查詢單一地理區域劃分的代表資訊。