Ta strona została przetłumaczona przez Cloud Translation API.

Specyfikacja danych dotyczących wyborów w krajowym dokumencie tożsamości

Dokument ten zawiera specyfikację danych niezbędnych do Google będzie udostępniać lokale wyborcze i informacje o kandydatach do Wybory krajowe oparte na legitymacji obywatelskiej. Ten dokument jest wersją roboczą specyfikacji którego głównym celem jest zbieranie opinii i może się zmienić w przyszłości.

Tabele

Poniższy zestaw tabel należy podać jako osobne rozdzielone tabulatorami value (TSV). Każdy plik powinien zaczynać się od wiersz nagłówka z listą pól do danej tabeli. Opcjonalne pola nagłówka nie muszą być uwzględniane, jeśli nie ma danych dla odpowiednich . Kolejne wiersze w pliku zawierają wiersze danych z w tej samej kolejności, co określone w wierszu nagłówka.

Pliki powinny mieć odpowiednią nazwę i spakować je w pliku ZIP. archiwum. Pliki powinny mieć nazwy: voicers.tsv, votesGroups.tsv, okręgi.tsv, odpytaniaLokalizacje.tsv, kandydaci.tsv, biura.tsv.

O ile nie wskazano inaczej, każde pole wskazane w tej specyfikacji jest ciąg znaków. Pliki TSV nie wymagają zmiany znaczenia przecinków ani znaków specjalnych. innych niż tabulatory. Ponieważ karty nie są odpowiednie dla żadnej z: pól w dowolnej tabeli, wyraźnie zabraniamy im uprawiania sportu w terenie.

* Służy do wskazania wymaganego pola w tabeli
** Służy do wskazywania pola wymaganego, które jest również kluczem podstawowym ta tabela (dwa wiersze nie mogą mieć takiej samej wartości w tym polu)
^Æ oznacza pole, które musi zostać umiędzynarodowione.

Internacjonalizacja

Aby dane były wyświetlane we właściwym języku niektóre pola w wierszu nagłówka muszą zawierać specyfikację języka. W niektórych krajach trzeba uwzględnić więcej niż jeden język danych dostępnych w więcej niż jednym języku. Dla tych krajów kolumny mogą mieć powtórzony z innym językiem dodanym na końcu kolumny i oddzielając je łącznikiem, np. PartyAffiliation-en.

Aby utworzyć języki, zapoznaj się ze stroną interfejsów API Google w Identyfikatory języków, krajów, walut i stref czasowych Parametry te opierają się Sprawdzone metody 47 – Tagi for Identitying Languages (BCP 47). Patrz Dodatek Przykładowe tagi języka: A w formacie BCP 47.

Tabela 1 – tabela wyborców (wymagana)

NationalVoterId**, VoterGroupId

Wiersz w tabeli wyborców oznacza jednego wyborcę. Każdy wyborca w krajowy dokument tożsamości lub dokument potwierdzający tożsamość wyborcy jest przechowywany w NationalVoterId. VoterGroupId wskazuje, do której grupy wyborczej do którego należy wyborca.

Uwaga: w krajach, w których nie ma logicznej grupy głosującej, VoterGroupId może być powtórzony z NationalVoterId. W takim przypadku tabela grup głosujących (tabela 2) przypisze wyborców bezpośrednio do identyfikatory okręgów i lokali wyborczych.

Tabela 2 – Tabela dla grup głosowania (wymagana)

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

Wiersz w tej tabeli wskazuje grupę głosującą, gdzie ta grupa głosu (przez PollingLocationId) i okręgach, do których należy ta grupa wyborcza do której należy. Każda grupa głosująca jest jednoznacznie identyfikowana przez VoterGroupId. Można podać wiele identyfikatorów okręgów, ponieważ grupa wyborcza może głosować na różnych urzędników na różnych szczeblach rządu. Na przykład w USA można głosować na gubernatora na na szczeblu stanowym, dyrektorem powiatu na poziomie hrabstwa oraz burmistrzem na poziomie miasta.

Uwagi: każda osoba w grupie głosującej powinna zostać głosowanie w tych samych konkursach i w tym samym lokalu wyborczym. O grupa głosująca powinna zostać podzielona na kilka grup do głosowania, jeśli ale nie o to.

Tabela 3 – tabela okręgów (wymagane)

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

Każdy wiersz w tabeli okręgów zawiera dane dotyczące okręgu wyborczego w tym informacje o lokalnych urzędnikach wyborczych. Nazwa urzędu w razie potrzeby pole powinno zawierać nazwę okręgu, np. Dystrykt Kolumbii.

Tabela 4 – Miejsce głosowania (wymagane)

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

Każda lokacja jest reprezentowana przez wiersz w lokalu wyborczym tabeli. Pole adresu powinno zawierać ciąg ze znakiem określony adres lokalizacji sondowania. Adresy mogą być używane do: podać linki do map, dzięki czemu adresy są nanoszone precyzyjnie na stronach geograficznych są idealnym. Jeśli nie można zmapować adresu, funkcja informacje będą przekazywane w formie tekstowej. Szerokość geograficzna oraz Długość geograficzna to pola opcjonalne zawierające szerokość geograficzną oraz długość geograficzna. Podawanie współrzędnych geograficznych zapewnia informacje o błędzie podczas sprawdzania wyników dotyczących lokalizacji odpytywania.

Pole Dodatkowe wskazówki jest opcjonalne i może zawierać wskazówki niezbędne do znalezienia lokalu wyborczego, np. wewnątrz budynku określony przez adres. Pole ContactInfo powinno zawierać informacje niezbędne do skontaktowania się z urzędnikami odpowiedzialnymi za tę miejsca głosowania.

Tabela 5 – Tabela kandydatów (wymagana)

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

Każdy wiersz w tabeli kandydatów odpowiada kandydatowi. CandidateId jednoznacznie identyfikuje kandydata. Pole biura zawiera nazwę w urzędzie, o którego ubiega się ten kandydat. Inne pola w tej kolumnie tabeli zawierają informacje o kandydacie.

Tabela 6 – stół biurowy

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

Każde biuro ma w tej tabeli wiersz jednoznacznie identyfikowany przez parametr identyfikator biura. Zawiera on również nazwę i opis biura. Pole DistrictId musi określać jeden z identyfikatorów okręgu wymienionych w pola ProwincjaDistrictId, CountyDistrictId lub LocalityDistrictId w tabeli Grupa głosowania. Urzędy, na które wszyscy głosują wyborcy, jako identyfikator okręgu należy używać WSZYSTKICH.

Przykłady

Przykładowe nagłówki pliku z danymi lokalizacji odpytywania

Plik: voicers.tsv
Nagłówek:

NationalVoterId        VoterGroupId

Plik: voiceGroups.tsv
Nagłówek:

VoterGroupId        PollingLocationId

Plik: queryingLocations.tsv
Nagłówek:

PollingLocationId        Address        HoursOfOperation

Przykładowy nagłówek pliku w wielu językach

Jeśli w danym kraju istnieje kilka języków, nagłówki poszczególnych plików mogą mieć dodatkowe pola wskazujące język/region uwzględnionych danych w tej dziedzinie. Tylko pola oznaczone jako możliwe do umiędzynarodowienia, Np. ze znacznikiem ^Æ w opisach tabel powyżej powinno być języka.