Representatives

このコレクションには、政治的な地理や公選された役職者の情報が含まれます。

このリソースのメソッドの一覧は、このページの最後に掲載されています。

<ph type="x-smartling-placeholder">

リソース表記

このコレクションのリソースには、以下で詳しく説明する 3 つのセクションがあります。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 識別子。
divisions.(key).alsoKnownAs[] list 同じ部門を参照するその他の有効な OCD ID。

OCD ID は人間が読み取れるもので、少なくともある程度予測可能なものであるため、1 つの部門に複数の識別子が存在することがあります。これらの識別子は互いに同じものとして定義され、常にメインの識別子として示されます。プライマリ ID は上記の ocd_id で返され、他の同等の有効な識別子がこのリストで返されます。

たとえば、この部門の OCD ID が ocd-division/country:us/district:dc の場合、ocd-division/country:us/state:dc が含まれます。
divisions.(key).name string 部門の名前。
divisions.(key).officeIndices[] list offices 配列内のインデックスのリスト。この部門から選出された各オフィスに 1 つずつあります。リクエストで includeOffices が true であった（または存在しない）場合にのみ存在します。

公選公職

プロパティ名 値 説明 メモ
offices[] list 上記の部門で参照される選出公職。リクエストで includeOffices が true の場合にのみ存在します。
offices[].divisionId string このオフィスが関連付けられている部門の OCD ID。
offices[].levels[] list このオフィスが属している政府のレベル。管轄区域が 2 つの異なるレベルの政府で実質的に活動している場合は、複数のケースが存在する可能性があります。例: コロンビア特別区の市長が「地域区分」で活動している場合administrativeArea2 と administrativeArea1 の両方で効果的に機能します。

有効な値は次のとおりです。
  • international -- 国際政府（国連や欧州連合など）。
  • country -- 国家レベルの政府機関（米国連邦政府など）。
  • administrativeArea1 -- 国の最上位の行政区域（米国の州など）の政府。
  • regional -- 管轄区域が標準的な行政区域をまたいでいる地方自治体これは米国では一般的ではありませんが、他の国の大都市では一般的です。
  • administrativeArea2 -- 国の第 2 階層の行政区画（米国の郡など）の政府機関。
  • locality -- 市または地方自治体。
  • subLocality1 -- 都市の最上位の行政区域（ワシントン DC など）の政府。
  • subLocality2 -- 都市の第 2 レベルの行政区画の政府（ワシントン DC の諮問ネイバーフッド カウンシルなど）。
  • 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 住所の 2 行目（必要に応じて）。
officials[].address[].line3 string 住所の 3 行目（必要な場合）。
officials[].address[].locationName string 場所の名前。
officials[].address[].state string 米国の 2 文字の州コード。
officials[].address[].zip string 住所の米国の郵便番号。
officials[].channels[] list その関係者の既知の（ソーシャル）メディア チャンネルのリスト。
officials[].channels[].id string 候補者のチャンネルの一意の公開識別子。
officials[].channels[].type string チャネルのタイプ。チャネルの種類のリストを以下に示しますが、すべてを網羅しているわけではありません。今後、他の種類のチャンネルが追加される場合もあります。次のいずれか: YouTube、Facebook、Twitter
officials[].emails[] list その公務員の直属のメールアドレス。
officials[].name string 担当者の名前。
officials[].party string その職員が所属する政党の氏名。
officials[].phones[] list その職員の一般公開の連絡先電話番号。
officials[].photoUrl string 公務員の写真の URL。
officials[].urls[] list その関係者の公開ウェブサイトの URL。

メソッド

representativeInfoByAddress
1 つの住所の政治的地理および代表的な情報を検索します。
representativeInfoByDivision
1 つの地域区分の代表的な情報を検索します。