Elections: voterInfoQuery

有権者の登録住所に基づいて、有権者に関連する情報を検索します。 実習をご覧ください。

返される情報には以下が含まれます。
  • 特定の住宅地の住所への投票所（早期投票所を含む）
  • コンテストと候補者の情報
  • 選挙公務員の情報

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 値 説明
必須のクエリ パラメータ
address string 検索する有権者の登録住所。
省略可能なクエリ パラメータ
electionId long

検索する選挙の一意の ID。選挙 ID のリストは https://www.googleapis.com/civicinfo/{version}/elections で取得できます。

クエリで選挙 ID が指定されず、特定の投票者のデータを含む複数の選挙がある場合は、otherElections レスポンス フィールドに追加の選挙が提供されます。

指定された投票者の住所にライブ選挙がない場合、レスポンスは選挙 ID が指定されている場合のみデータを返します。

この場合は、正しい投票場所、コンテスト、選挙公式情報（該当する場合）がユーザーに確実に提供されるように、指定された選挙 ID を使用して 2 つ目のクエリを発行することをおすすめします。
officialOnly boolean true に設定した場合、州の正式なソースからのデータのみが返されます。 （デフォルト: false）。

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "civicinfo#voterInfoResponse",
  "election": elections Resource,
  "otherElections": [
    elections Resource
  ],
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "pollingLocations": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "earlyVoteSites": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "dropOffLocations": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "contests": [
    {
      "type": string,
      "primaryParty": string,
      "electorateSpecifications": string,
      "special": string,
      "ballotTitle": string,
      "office": string,
      "level": [
        string
      ],
      "roles": [
        string
      ],
      "district": {
        "name": string,
        "scope": string,
        "id": string
      },
      "numberElected": long,
      "numberVotingFor": long,
      "ballotPlacement": long,
      "candidates": [
        {
          "name": string,
          "party": string,
          "candidateUrl": string,
          "phone": string,
          "photoUrl": string,
          "email": string,
          "orderOnBallot": long,
          "channels": [
            {
              "type": string,
              "id": string
            }
          ]
        }
      ],
      "referendumTitle": string,
      "referendumSubtitle": string,
      "referendumUrl": string,
      "referendumBrief": string,
      "referendumText": string,
      "referendumProStatement": string,
      "referendumConStatement": string,
      "referendumPassageThreshold": string,
      "referendumEffectOfAbstain": string,
      "referendumBallotResponses": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "state": [
    {
      "name": string,
      "electionAdministrationBody": {
        "name": string,
        "electionInfoUrl": string,
        "electionRegistrationUrl": string,
        "electionRegistrationConfirmationUrl": string,
        "electionNoticeText": string,
        "electionNoticeUrl": string,
        "absenteeVotingInfoUrl": string,
        "votingLocationFinderUrl": string,
        "ballotInfoUrl": string,
        "electionRulesUrl": string,
        "voter_services": [
          string
        ],
        "hoursOfOperation": string,
        "correspondenceAddress": {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        },
        "physicalAddress": {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        },
        "electionOfficials": [
          {
            "name": string,
            "title": string,
            "officePhoneNumber": string,
            "faxNumber": string,
            "emailAddress": string
          }
        ]
      },
      "local_jurisdiction": (AdministrationRegion),
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "mailOnly": boolean
}
プロパティ名 値 説明 メモ
kind string リソースの種類を指定します。値: 固定文字列 "civicinfo#voterInfoResponse"。
election nested object クエリされた選挙。
otherElections[] list 投票者の住所に複数の選挙がある場合は、API レスポンスの otherElections フィールドに値が入力されます。これには 2 つの可能性があります。

1.これらの選挙が別々の日に行われる場合、API は最初または最も早い選挙の投票情報を返します。最も早い選挙が意図された選挙でない場合は、2 番目の API リクエストで electionId フィールドを使用して、目的の選挙の選挙 ID を指定します。

2.これらの選挙が同じ日に行われた場合、API は、追加のクエリが確実に行われるように投票所、コンテスト、選挙公式の情報を返しません。ユーザー向けのアプリケーションの場合、曖昧さをなくすために、これらの選択をユーザーに表示することをおすすめします。ユーザーに関連する選挙のために、electionId フィールドを使用する 2 つ目の API リクエストを行う必要があります。
normalizedInput nested object リクエストされた住所の正規化バージョン
normalizedInput.locationName string 場所の名前。
normalizedInput.line1 string この住所の番地。
normalizedInput.line2 string 住所の 2 行目（必要に応じて）。
normalizedInput.line3 string 住所の 3 行目（必要な場合）。
normalizedInput.city string 住所の市区町村。
normalizedInput.state string 米国の 2 文字の州コード。
normalizedInput.zip string 住所の米国の郵便番号。
mailOnly boolean 選挙区内の有権者が、投票用紙を郵送するだけで投票できるようにするかどうかを指定します（投票用紙を送達することもできます）。

投票所、早期投票所、投票所

プロパティ名 値 説明 メモ
pollingLocations[] list 投票日に投票できる場所。
pollingLocations[].address nested object ビジネスの住所です。
pollingLocations[].address.locationName string 場所の名前。
pollingLocations[].address.line1 string この住所の番地。
pollingLocations[].address.line2 string 住所の 2 行目（必要に応じて）。
pollingLocations[].address.line3 string 住所の 3 行目（必要な場合）。
pollingLocations[].address.city string 住所の市区町村。
pollingLocations[].address.state string 米国の 2 文字の州コード。
pollingLocations[].address.zip string 住所の米国の郵便番号。
pollingLocations[].notes string この場所に関する注意事項（スロープ、入口など）。
pollingLocations[].pollingHours string ビジネスの営業時間についての説明です。
pollingLocations[].name string 期日前投票所または降車場所の名前。このフィールドは、投票所の場所では入力されません。
pollingLocations[].voterServices string この早期投票所または降車場所が提供するサービス。このフィールドは、投票所の場所では入力されません。
pollingLocations[].startDate string この早期投票所または降車場所が使用される最初の日付です。このフィールドは、投票所の場所では入力されません。
pollingLocations[].endDate string この早期投票所または降車場所が使用できる最終日です。このフィールドは、投票所の場所では入力されません。
pollingLocations[].latitude string 場所の緯度（赤道の北の度数）。このフィールドは、一部の地域では使用できない場合があります。
pollingLocations[].longitude string 子午線の東の度数で示される場所の経度。このフィールドは、一部の地域では使用できない場合があります。
pollingLocations[].sources[] list このビジネスのソースのリスト。複数のソースがリストされている場合、データはそれらのソースから集計されています。
pollingLocations[].sources[].name string データソースの名前。
pollingLocations[].sources[].official boolean データが政府の正式な情報源からのものであるかどうか。
earlyVoteSites[] list 投票日前に有権者が早め投票できる場所。
earlyVoteSites[].address nested object ビジネスの住所です。
earlyVoteSites[].address.locationName string 場所の名前。
earlyVoteSites[].address.line1 string この住所の番地。
earlyVoteSites[].address.line2 string 住所の 2 行目（必要に応じて）。
earlyVoteSites[].address.line3 string 住所の 3 行目（必要な場合）。
earlyVoteSites[].address.city string 住所の市区町村。
earlyVoteSites[].address.state string 米国の 2 文字の州コード。
earlyVoteSites[].address.zip string 住所の米国の郵便番号。
earlyVoteSites[].notes string この場所に関する注意事項（スロープ、入口など）。
earlyVoteSites[].pollingHours string ビジネスの営業時間についての説明です。
earlyVoteSites[].name string 期日前投票所または降車場所の名前。このフィールドは、投票所の場所では入力されません。
earlyVoteSites[].voterServices string この早期投票所または降車場所が提供するサービス。このフィールドは、投票所の場所では入力されません。
earlyVoteSites[].startDate string この早期投票所または降車場所が使用される最初の日付です。このフィールドは、投票所の場所では入力されません。
earlyVoteSites[].endDate string この早期投票所または降車場所が使用できる最終日です。このフィールドは、投票所の場所では入力されません。
earlyVoteSites[].latitude string 場所の緯度（赤道の北の度数）。このフィールドは、一部の地域では使用できない場合があります。
earlyVoteSites[].longitude string 子午線の東の度数で示される場所の経度。このフィールドは、一部の地域では使用できない場合があります。
earlyVoteSites[].sources[] list このビジネスのソースのリスト。複数のソースがリストされている場合、データはそれらのソースから集計されています。
earlyVoteSites[].sources[].name string データソースの名前。
earlyVoteSites[].sources[].official boolean データが政府の正式な情報源からのものであるかどうか。
dropOffLocations[] list 有権者が記入済みの投票用紙を降ろせる場所。投票者は投票所に到着する前に投票用紙を受け取り、それを完成している必要があります。その施設には投票用紙が用意されていない場合があります。これらの場所は、pollingHours フィールドに示されているように、選挙日またはその前に営業している場合があります。
dropOffLocations[].address nested object ビジネスの住所です。
dropOffLocations[].address.locationName string 場所の名前。
dropOffLocations[].address.line1 string この住所の番地。
dropOffLocations[].address.line2 string 住所の 2 行目（必要に応じて）。
dropOffLocations[].address.line3 string 住所の 3 行目（必要な場合）。
dropOffLocations[].address.city string 住所の市区町村。
dropOffLocations[].address.state string 米国の 2 文字の州コード。
dropOffLocations[].address.zip string 住所の米国の郵便番号。
dropOffLocations[].notes string この場所に関する注意事項（スロープ、入口など）。
dropOffLocations[].pollingHours string ビジネスの営業時間についての説明です。
dropOffLocations[].name string 期日前投票所または降車場所の名前。このフィールドは、投票所の場所では入力されません。
dropOffLocations[].voterServices string この早期投票所または降車場所が提供するサービス。このフィールドは、投票所の場所では入力されません。
dropOffLocations[].startDate string この早期投票所または降車場所が使用される最初の日付です。このフィールドは、投票所の場所では入力されません。
dropOffLocations[].endDate string この早期投票所または降車場所が使用できる最終日です。このフィールドは、投票所の場所では入力されません。
dropOffLocations[].latitude string 場所の緯度（赤道の北の度数）。このフィールドは、一部の地域では使用できない場合があります。
dropOffLocations[].longitude string 子午線の東の度数で示される場所の経度。このフィールドは、一部の地域では使用できない場合があります。
dropOffLocations[].sources[] list このビジネスのソースのリスト。複数のソースがリストされている場合、データはそれらのソースから集計されています。
dropOffLocations[].sources[].name string データソースの名前。
dropOffLocations[].sources[].official boolean データが政府の正式な情報源からのものであるかどうか。

コンテスト

プロパティ名 値 説明 メモ
contests[] list 投票者の投票用紙に表示されるコンテスト。
contests[].type string コンテストの種類。通常は、[General]、[Primary]、[Run-off] のいずれかです。採用することもできます国民投票では「国民投票」といいます。
contests[].primaryParty string 特定の党による選挙の場合は対象の政党の名前。
contests[].electorateSpecifications string このコンテストの投票に関するその他の資格要件の説明。
contests[].special string 「はい」または「いいえ」コンテストが通常の選挙期間外に実施されるかどうかによって、
contests[].ballotTitle string このコンテストの投票用紙の公式タイトル（利用可能な場合）。
contests[].office string このコンテストの事務所の名前。
contests[].level[] list このコンテストの事務所がある政府のレベル。管轄区域が 2 つの異なるレベルの政府で実質的に活動している場合は、複数のケースが存在する可能性があります。たとえば、コロンビア特別区の市長は locality レベルで活動しているが、実質的には administrativeArea2 と administrativeArea1 の両方で活動している。

有効な値は次のとおりです。
  • international -- 国際政府機関（国連や欧州連合など）。
  • country -- 国家レベルの政府（米国連邦政府など）。
  • administrativeArea1 -- 国の最上位の行政区域（米国の州など）の政府。
  • regional -- 管轄区域が標準的な行政区域をまたいでいる地方自治体これは米国では一般的ではありませんが、他の国の大都市では一般的です。
  • administrativeArea2 -- 国の第 2 階層の行政区画（米国の郡など）の政府機関。
  • locality -- 市または地方自治体。
  • subLocality1 -- 都市の最上位の行政区域（ワシントン DC など）の政府。
  • subLocality2 -- ワシントン DC の勧告 Neighborhood Council など、都市の第二レベルの行政区画の政府。
  • special -- 特別な目的の政府のためにのみ存在する地方区（土壌保全地域、水保全地域など）。
contests[].roles[] list このコンテストが果たす役割ロールは、すべてを網羅するものではなく、特定のオフィスの一連の責務を正確に指定するものではありませんが、オフィスのリストからの一般的な選択や並べ替えに役立つ大まかなカテゴリです。

有効な値は次のとおりです。
  • headOfState -- 政府の代表者。通常、ある国の国家元首は「大統領」と呼ばれます。
  • headOfGovernment -- 政府の最高経営責任者。米国では大統領、他の国では首相が下位レベルでは、知事または市長が指名します。
  • deputyHeadOfGovernment -- 選出された政府長の死亡または就職時に、政府の代表者を担う責任者。米国ではバイス プレジデント、このオフィスは、他の職務を担うこともあります。
  • governmentOfficer -- 選出された執行役員。米国の州では、司法長官、長官、州務長官、財務担当者などの職務が含まれます。
  • executiveCouncil -- グループとして執行役員の役割を果たす執行委員会のメンバー。たとえば、インディアナ郡の長官などが該当します。
  • legislatorUpperBody -- 二院制議会の上院議員、または一院制議会の唯一の議員。
  • legislatorLowerBody -- 二院制議会の下院議員。
  • highestCourtJudge -- 州最高裁判所など、特定の政府の最高裁判所の裁判官。
  • judge -- 担当する政府の最高裁判所ではない裁判所の判事。
  • schoolBoard -- 地域の教育委員会のメンバー。
  • specialPurposeOfficer -- 定められた単一の目的を果たす職員（土壌水保全委員会や昆虫駆除担当者など）。
contests[].district nested object このコンテストが実施されている選挙区に関する情報です。
contests[].district.name string 地区の名前。
contests[].district.scope string この地区の地理的範囲。指定しない場合、地区の地域は不明です。次のいずれか: 全国、州全体、下院、州上位、州下、郡全体、司法、教育委員会、市全体、町、郡、市議会、市議会、区、特別

指定できる値は次のとおりです。 <ph type="x-smartling-placeholder">
    </ph>
  • 「cityCouncil」
  • "citywide"
  • "congressional"
  • "countyCouncil"
  • "countywide"
  • "judicial"
  • "national"
  • "schoolBoard"
  • "special"
  • "stateLower"
  • "stateUpper"
  • "statewide"
  • "township"
  • 「ward」
contests[].district.id string 範囲に対するこの学区の識別子。たとえば、第 34 州議会上院選挙区の ID は「34」になります。stateUpper のスコープです
contests[].numberElected long このコンテストの候補者の人数です。
contests[].numberVotingFor long このコンテストで投票できる候補者の数。
contests[].ballotPlacement long 投票者の投票用紙におけるこの選挙の順位を示す番号。
contests[].candidates[] list 本コンテストの候補者の選択肢。
contests[].candidates[].name string 受験者の名前。
contests[].candidates[].party string 候補者が所属する政党の氏名。
contests[].candidates[].candidateUrl string 候補者のキャンペーン ウェブサイトの URL。
contests[].candidates[].phone string 候補者の選挙管理事務所の代表電話番号。
contests[].candidates[].photoUrl string 候補者の写真の URL。
contests[].candidates[].email string 候補者のキャンペーンのメールアドレス。
contests[].candidates[].orderOnBallot long このコンテストの投票用紙に表示される候補者の順位。
contests[].candidates[].channels[] list この候補者の既知の（ソーシャル）メディア チャンネルのリスト。
contests[].candidates[].channels[].type string チャネルのタイプ。チャネルの種類のリストを以下に示しますが、すべてを網羅しているわけではありません。今後、他の種類のチャンネルが追加される場合もあります。次のいずれか:
  • GooglePlus
  • YouTube
  • Facebook
  • Twitter
contests[].candidates[].channels[].id string 候補者のチャンネルの一意の公開識別子。
contests[].referendumTitle string 国民投票のタイトル（例: 「提案 42」）。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumSubtitle string 国民投票の簡単な説明。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumUrl string 国民投票へのリンク。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumBrief string 国民投票の短い要約を指定します。通常はタイトルの下、テキストの上にある投票用紙に記載されます。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumText string 国民投票の全文。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumProStatement string 国民投票に賛同する声明。必ずしも投票に記載されるとは限りません。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumConStatement string 国民投票に反対する声明。必ずしも投票に記載されるとは限りません。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumPassageThreshold string 国民投票で合格するために必要となる投票数のしきい値。例:「two-thirds」と入力します。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumEffectOfAbstain string 提案に投票しないでおくとどのような影響があるか（つまり、投票しないでいることを反対の投票とみなすかどうか）を指定します。このフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].referendumBallotResponses[] list 国民投票の投票回答のセット。投票の回答は、投票上の行を表します。一般的な例は「はい」です。または「no」定着率向上コンテストでは 裁判官の名前を使いますこのフィールドは、タイプが「Referendum」のコンテストの場合のみ入力されます。
contests[].sources[] list このコンテストのソースのリスト。複数のソースがリストされている場合、データはそれらのソースから集計されています。
contests[].sources[].name string データソースの名前。
contests[].sources[].official boolean データが政府の正式な情報源からのものであるかどうか。

選挙関係者

プロパティ名 値 説明 メモ
state[] list 有権者が投票する州の地方選挙情報。米国の場合、この配列の要素は 1 つだけです。
state[].name string 法域の名前。
state[].electionAdministrationBody nested object この地域の選挙管理機関。
state[].electionAdministrationBody.name string この選挙管理団体の名前。
state[].electionAdministrationBody.electionInfoUrl string 一般選挙に関する情報を検索するために、この行政機関が提供する URL です。
state[].electionAdministrationBody.electionRegistrationUrl string 有権者登録方法を検索するためにこの行政機関が提供する URL。
state[].electionAdministrationBody.electionRegistrationConfirmationUrl string 有権者が有権者として登録されていることを確認するためにこの行政機関が提供する URL。
state[].electionAdministrationBody.electionNoticeText string この行政機関が提供する土壇場または緊急通知のテキスト。
state[].electionAdministrationBody.electionNoticeUrl string 直前または緊急通知に関する追加情報のために、この行政機関が提供する URL。
state[].electionAdministrationBody.absenteeVotingInfoUrl string 欠席者投票に関する情報を得るために、この行政機関が提供する URL。
state[].electionAdministrationBody.votingLocationFinderUrl string 投票所を検索するためにこの行政機関が提供する URL。
state[].electionAdministrationBody.ballotInfoUrl string 投票者にコンテストの情報を提供するためにこの行政機関が提供する URL。
state[].electionAdministrationBody.electionRulesUrl string 投票者に選挙規則を説明する、この行政機関が提供する URL。
state[].electionAdministrationBody.voter_services[] list この行政機関が提供する可能性があるサービスの説明。
state[].electionAdministrationBody.hoursOfOperation string この行政機関の営業時間の説明。
state[].electionAdministrationBody.correspondenceAddress nested object 当該政府機関の送付先住所。
state[].electionAdministrationBody.correspondenceAddress.locationName string 場所の名前。
state[].electionAdministrationBody.correspondenceAddress.line1 string この住所の番地。
state[].electionAdministrationBody.correspondenceAddress.line2 string 住所の 2 行目（必要に応じて）。
state[].electionAdministrationBody.correspondenceAddress.line3 string 住所の 3 行目（必要な場合）。
state[].electionAdministrationBody.correspondenceAddress.city string 住所の市区町村。
state[].electionAdministrationBody.correspondenceAddress.state string 米国の 2 文字の州コード。
state[].electionAdministrationBody.correspondenceAddress.zip string 住所の米国の郵便番号。
state[].electionAdministrationBody.physicalAddress nested object この政府機関の住所。
state[].electionAdministrationBody.physicalAddress.locationName string 場所の名前。
state[].electionAdministrationBody.physicalAddress.line1 string この住所の番地。
state[].electionAdministrationBody.physicalAddress.line2 string 住所の 2 行目（必要に応じて）。
state[].electionAdministrationBody.physicalAddress.line3 string 住所の 3 行目（必要な場合）。
state[].electionAdministrationBody.physicalAddress.city string 住所の市区町村。
state[].electionAdministrationBody.physicalAddress.state string 米国の 2 文字の州コード。
state[].electionAdministrationBody.physicalAddress.zip string 住所の米国の郵便番号。
state[].electionAdministrationBody.electionOfficials[] list 本選挙管理団体の選挙管理人。
state[].electionAdministrationBody.electionOfficials[].name string 選挙高官の氏名。
state[].electionAdministrationBody.electionOfficials[].title string 選挙高官の役職。
state[].electionAdministrationBody.electionOfficials[].officePhoneNumber string 選挙高官のオフィスの電話番号。
state[].electionAdministrationBody.electionOfficials[].faxNumber string 選挙高官のファックス番号。
state[].electionAdministrationBody.electionOfficials[].emailAddress string 選挙管理人のメールアドレス。
state[].local_jurisdiction nested object この投票者の選挙情報を提供する市または郡。このオブジェクトは状態と同じ要素を持つことができます。
state[].sources[] list このエリアのソースのリスト。複数のソースがリストされている場合、データはそれらのソースから集計されています。
state[].sources[].name string データソースの名前。
state[].sources[].official boolean データが政府の正式な情報源からのものであるかどうか。

試してみよう: