このページは Cloud Translation API によって翻訳されました。

国民 ID 選挙データ仕様

このドキュメントでは、 Google は、投票所の場所と候補者の情報を提供国民 ID に基づく選挙。このドキュメントは仕様のドラフトですは主にフィードバックを求めることを意図しており、今後変更される可能性があります。

テーブル

次のテーブルのセットは、個別のテーブルとして用意する必要があります。タブ区切り value（TSV）ファイルです。各ファイルの先頭は 1 つだけにしてください。そのテーブルのフィールドがリストされているヘッダー行です。オプションのヘッダーフィールド対応する ID のデータがない場合は、表示されます。ファイルの後続の行には、フィールドは、ヘッダー行で指定された順序と同じ順序で返されます。

ファイルには適切な名前を付けて、zip 内にバンドルする必要があります。アーカイブできますファイル名は、voters.tsv、votingGroups.tsv、 Districts.tsv、pollingLocations.tsv、suggests.tsv、offices.tsv。

特に明記されていない限り、本仕様で示される各フィールドは、指定します。TSV ファイルでは、カンマや特殊文字用のエスケープは不要です。文字は使用できません。タブは明示的に指定することはできません。明示的に示しています

* は表の必須フィールドを示します。
** は必須項目を示します。これは、データソースのそのテーブル（このフィールドに 2 つの行で同じ値を指定することはできません）
^Æ は、国際化する必要があるフィールドを示します。

国際化

データが正しい言語で表示されるようにするためにヘッダー行の一部のフィールドで、言語 / 地域を指定する必要がある。国によっては複数の言語データが必要なため、複数言語で記述されています。このような国の場合、列は列の末尾に別の言語 / 地域を追加して繰り返します。ダッシュで区切ります（例:PartyAffiliation-en。

言語 / 地域を作成するには、 <ph type="x-smartling-placeholder"></ph> 言語、国、通貨、タイムゾーンの識別子。これらの仕様は現在のベストプラクティス 47 - 言語を識別するためのタグ（BCP 47）付録を参照してください。言語タグの例については、BCP 47 の A をご覧ください。

表 1 - 投票者テーブル（必須）

NationalVoterId**, VoterGroupId

投票者テーブルの行は、単一の投票者を表します。各選挙区の投票者は、国に国民 ID または投票者 ID がある場合、この情報は NationalVoterId フィールド。VoterGroupId は、このエンティティができます。

注: 論理投票グループが存在しない国では、 VoterGroupId は NationalVoterId の繰り返しにできます。この場合、投票グループの表（表 2）では、投票者を選挙区 ID と投票所 ID で構成されています。

表 2 - 投票グループテーブル（必須）

VoterGroupId**, PollingLocationId*, ProvinceDistrictId,
CountyDistrictId, LocalityDistrictId

この表の行は投票グループを識別し、そのグループはの投票数（PollingLocationId 経由）、およびこの投票グループの選挙区属します各投票グループは VoterGroupId。複数の学区 ID は、投票グループは、さまざまなレベルの議員に投票するか、あります。たとえば米国では、州レベル、郡レベルの行政官、市長表示されます

注: 投票グループのメンバーは全員、投票すること。投票グループを複数の投票グループに分割する必要があります。違います。

表 3 - 学区の表（必須）

DistrictId**, AuthorityName*, LocalElectionOfficialName*,
LocalElectionOfficialPhone*, LocalElectionUrl*,
LocalElectionOfficialEmail, LocalElectionOfficialAddress

選挙区テーブルの各行には、選挙区のデータが含まれる地域の選挙情報などオーソリティ名フィールドには、必要に応じて学区の名前、例:コロンビア特別区。

表 4 - ポーリングの場所（必須）

PollingLocationId**, Address*^Æ, Latitude, Longitude,
HoursOfOperation^Æ, AdditionalDirections^Æ,
ContactInfo^Æ

各ポーリング位置は、ポーリング位置の行で表される表します住所フィールドには、完全な住所の文字列を指定されたアドレスです。住所の用途地図のリンクを提供して、地理上のウェブサイトで住所を正確にマッピングできるようにする理想的ですマッピング可能なアドレスが使用できない場合、テキストとしてユーザーに提供されます。緯度と経度経度は、測地的な緯度と経度を含むオプションのフィールドです。経度。緯度と経度を提供するとポーリングの場所の結果のエラーチェックに関する情報。

[AdditionalDirections] フィールドは省略可能であり、ルートが含まれている場合があります。投票所を探すために必要なものだからです。建物内 IP アドレスで指定されますContactInfo フィールドには、関連する責任者に連絡するために必要な情報場所を指定します。

表 5 - Candidate テーブル（必須）

CandidateId**, CandidateName*^Æ,
PartyAffiliation^Æ, OfficeId*, Url,
CampaignAddress^Æ, Photo, Phone, TwitterHandle,
FacebookUsername, Email, YoutubeChannel

candidate テーブルの各行は 1 人の候補者を表します。CandidateId 一意に識別するものです「オフィス」フィールドにはオフィスの所在地になります。このフィールドのテーブルは受験者に関する情報を提供します。

表 6 - オフィスのテーブル

OfficeId**, DistrictId*, Name^Æ, Term^Æ,
Description^Æ

このテーブルでは、各オフィスの行がテーブルごとに一意に識別され、オフィス ID。オフィスの名前と説明も含まれます。 DistrictId フィールドには、 ProvinceDistrictId、 CountyDistrictId、LocalityDistrictId のフィールド投票グループのテーブルに表示されます全員によって投票されたオフィス用 ALL を学区 ID として使用してください。

サンプル

ポーリングの場所データファイルヘッダーのサンプル

ファイル: voters.tsv
ヘッダー:

NationalVoterId        VoterGroupId

ファイル: votingGroups.tsv
ヘッダー:

VoterGroupId        PollingLocationId

ファイル: pollingLocations.tsv
ヘッダー:

PollingLocationId        Address        HoursOfOperation

複数言語ファイルのヘッダーの例

1 つの国に複数の言語がある場合、各ファイルのヘッダーには含まれるデータの言語/地域を示す追加フィールドそのフィールドに表示されます「国際化可能」とマークされたフィールドのみがつまり、上記の表の説明では、^Æ マーカーを言語 / 地域を追加しました。