Representatives

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

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

リソース表記

このコレクションのリソースには、後述する 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 つの部門に複数の識別子が存在することがあります。これらの識別子は互いに同等になるように定義され、一方は常にメインの識別子として示されます。プライマリ識別子は上記の 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 -- ワシントン DC のアドバイザリー ネイバーフッド カウンシルなど、都市の第 2 次行政区画の政府。
  • 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 受験者のチャンネルの一意の公開 ID。
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。

Methods

representativeInfoByAddress
1 つの住所の行政区域と代表的な情報を検索します。
representativeInfoByDivision
1 つの地域区分の代表情報を検索します。