有権者の登録住所に基づいて、その有権者に関連する情報を検索します。実習をご覧ください。
返される情報には
- 特定の住宅の住所の投票所(早期投票所を含む)
- コンテストおよび受験者情報
- 選挙に関する公式情報
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/civicinfo/v2/voterinfo
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
必須のクエリ パラメータ | ||
address |
string |
検索する有権者の登録住所。 |
省略可能なクエリ パラメータ | ||
electionId |
long |
検索する選挙の一意の ID。選挙 ID のリストは、https://www.googleapis.com/civicinfo/{version}/elections で取得できます。 クエリで選挙 ID が指定されず、指定された投票者のデータを含む複数の選挙がある場合は、追加の選挙が 指定された投票者の住所に現在有効な選挙がない場合は、選挙 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 |
1 つの投票者の住所に複数の選挙がある場合、API レスポンスの otherElections フィールドに値が入力されます。次の 2 つの可能性があります。1.これらの選挙が別々の日に行われる場合、API は最初または最も早い選挙の投票情報を返します。最初の選挙が意図した選挙でない場合は、 electionId フィールドを使用して 2 番目の API リクエストで目的の選挙の選挙 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 |
コンテストのタイプ。候補者とのコンテストの場合、通常は [全般]、[メイン]、[ランオフ] のいずれかになります。住民投票の場合は「住民投票」となります。 | |
contests[].primaryParty |
string |
特定の党の選挙の場合は、その選挙の政党の名前。 | |
contests[].electorateSpecifications |
string |
このコンテストの投票に関するその他の資格要件についての説明。 | |
contests[].special |
string |
通常の選挙期間外で開催されるかどうかに応じて、[はい] または [いいえ] を選択します。 | |
contests[].ballotTitle |
string |
このコンテストの投票用紙の正式なタイトル(利用可能な場合)。 | |
contests[].office |
string |
このコンテストのオフィスの名前。 | |
contests[].level[] |
list |
このコンテストに参加する行政レベル。管轄区域が 2 つの異なる行政レベルで実質的に行動する場合、複数の行政区域が複数存在することがあります。たとえば、コロンビア特別区の市長は locality レベルで活動するが、 administrativeArea2 と administrativeArea1 の両方において実質的に活動する場合もあります。有効な値は次のとおりです。
|
|
contests[].roles[] |
list |
このコンテストで果たす役割。ロールは、網羅的なものではなく、特定のオフィスの責任全体を正確に指定するものではなく、オフィスのリストの一般的な選択や並べ替えに役立つ大まかなカテゴリを意図しています。 有効な値は次のとおりです。
|
|
contests[].district |
nested object |
このコンテストが行われる選挙区に関する情報。 | |
contests[].district.name |
string |
地区の名前。 | |
contests[].district.scope |
string |
この学区の地理的範囲。指定しない場合、学区の地域は不明です。次のいずれか: National、statewide、congressional、stateUpper、state 下位、countywide、judicial、schoolBoard、cityWide、township、countyCouncil、cityCouncil、ward、special
指定できる値は次のとおりです。
|
|
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 |
チャネルのタイプ。以下に、チャネルの種類の一覧を示します(すべてを網羅しているわけではありません)。今後、チャンネルの種類が追加される可能性があります。次のいずれか:
|
|
contests[].candidates[].channels[].id |
string |
受験者のチャンネルの一意の公開 ID。 | |
contests[].referendumTitle |
string |
国民投票の名称(例: 「提案 42」)。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumSubtitle |
string |
住民投票についての簡単な説明。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumUrl |
string |
国民投票へのリンク。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumBrief |
string |
住民投票の短い要約を指定します。通常はタイトルの下、テキストの上に投票用紙に記載されます。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumText |
string |
国民投票の全文。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumProStatement |
string |
国民投票を支持する声明。必ずしも投票用紙に記載されるわけではありません。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumConStatement |
string |
国民投票に反対する声明。必ずしも投票用紙に記載されるわけではありません。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumPassageThreshold |
string |
住民投票の可決に必要な投票数のしきい値(「3 分の 2」など)。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumEffectOfAbstain |
string |
提案を放棄すること(投票しない)が与える影響(すなわち、提案を放棄した場合に反対票と見なされるかどうか)を指定します。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
contests[].referendumBallotResponses[] |
list |
国民投票の投票回答をまとめたものです。投票用紙に 1 行が記載されています。一般的な例としては、住民投票の「はい」か「いいえ」、保持コンテストの判事名などがあります。このフィールドに入力されるのは、「住民投票」タイプのコンテストのみです。 | |
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。投票者に選挙ルールを説明する 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 |
選挙職員の FAX 番号。 | |
state[].electionAdministrationBody.electionOfficials[].emailAddress |
string |
選挙関係者のメールアドレス。 | |
state[].local_jurisdiction |
nested object |
この有権者の選挙情報を提供する市または郡。このオブジェクトには、状態と同じ要素を含めることができます。 | |
state[].sources[] |
list |
このエリアの情報源のリスト。複数のソースが表示されている場合、データはそれらのソースから集計されています。 | |
state[].sources[].name |
string |
データソースの名前。 | |
state[].sources[].official |
boolean |
このデータが政府の公式ソースから得られたものかどうか。 |