Biuro

Użyj właściwości Office, aby zdefiniować urząd i informacje powiązane z jego konkursem. Urząd jest identyfikowany na podstawie okręgu wyborczego i pełnionej funkcji.

Element Office ma zastosowanie do wszystkich typów plików danych, ale nie musi być określony w przypadku referendów.

Wybierz jeden z tych typów plików danych, aby dowiedzieć się więcej o tym, jak używać Office z danym typem pliku danych.

Atrybuty

W tabeli poniżej opisano atrybuty Office:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej opisano elementy Office:

Element Mnogość Typ Opis
ContactInformation 0 lub więcej ContactInformation Powiązywanie różnych informacji kontaktowych z biurem. Jeśli ten element jest uwzględniony, podaj tylko informacje związane z samym stanowiskiem, a nie z kandydatem lub osobą zajmującą to stanowisko.
ElectoralDistrictId 0 lub 1 IDREF

Podaj objectId GpUnit, który reprezentuje okręg wyborczy. Na przykład w przypadku senatora USA podaj stan, np. „Alaska”, a w przypadku przedstawiciela USA podaj okręg, np. „14 okręg wyborczy w Nowym Jorku”.

W przypadku pliku danych o osobach sprawujących urząd oczekujemy jednego elementu Office na każde miejsce oraz ustawienia elementu ElectoralDistrictId na okręg, w którym dana osoba została wybrana na urząd.

Przykład: wybory do tajwańskiego parlamentu

  • Przydziel każdemu członkowi Yuanu Ustawodawczego inny Office w zależności od okręgu.

Inny przykład: plik danych z informacjami o osobach sprawujących urząd senatora w USA

  • Podaj 100 obiektów Office dla Senatu Stanów Zjednoczonych.
ExternalIdentifiers 1 ExternalIdentifiers

Przypisuje identyfikator do biura. Wymagany jest stabilny identyfikator. Stałe identyfikatory urzędów muszą być niepowtarzalne w przypadku wszystkich okresów sprawowania urzędu. Na przykład każdy z tych okresów musi mieć odrębny identyfikator stabilny urzędu:

  • Prezydentura Grovera Clevelanda w latach 1885–1889
  • Prezydentura Grovera Clevelanda w latach 1893–1897
  • prezydentura Franklina Roosevelta w latach 1933–1945,

Element ExternalIdentifiers w Office umożliwia podanie dodatkowych informacji z określonymi wartościami dla OtherType. Więcej informacji znajdziesz w sekcji Dodatkowe typy dla ExternalIdentifiers.
GovernmentBodyIds 0 lub 1 IDREFS Podaj objectId GovernmentBody, do którego należy to biuro. Na przykład Senat Stanów Zjednoczonych w przypadku senatora USA.
Name 1 InternationalizedText Zawiera pełną nazwę ogólną tego urzędu. Musi ona zawierać jurysdykcję urzędu, ale nie może zawierać żadnych informacji związanych z okręgiem wyborczym.

Przykłady:

  • Członek parlamentu Singapuru
  • Premier Indii
  • Prezydent Indonezji
  • Senator Stanów Zjednoczonych
JurisdictionId 0 lub 1 IDREF

Podaj objectId GpUnit, który określa jurysdykcję urzędu.
Level 0 lub 1 OfficeLevel

Wyliczeniowy typ poziomu biura. Pełną listę opcji znajdziesz w dokumentacji.
Role 0 lub więcej OfficeRole Wyliczony typ roli biura, np. cabinet member lub president. Wszystkie możliwe opcje znajdziesz w dokumentacji.
OfficeHolderPersonIds 1 IDREFS

Podaj objectId Person, która sprawuje ten urząd.
SeatStatus 0 lub 1 SeatStatus Wyliczony typ stanu stanowiska, np.active lub on-leave. Jeśli nie określono wartości SeatStatus, domyślna wartość to active.
SelectionMethod 0 lub więcej OfficeSelectionMethod Informacje o tym, jak dana osoba została wybrana lub powołana na stanowisko.
Term 1 Term Zawiera informacje związane z kadencją urzędu.

Dodatkowe typy dla ExternalIdentifiers

W elemencie ExternalIdentifiers elementu Office podaj dodatkowe dane z elementem Type o wartości other oraz wartościami elementów OtherType i Value. W tabeli poniżej znajdziesz możliwe wartości tych elementów:

OtherType Przykładowe wartości Opis
jurisdiction-id gpu1

objectId GpUnit, który określa jurysdykcję urzędu.
government-body United States Senate Zobacz GovernmentBody.
legislative-session 116th United States Congress
office-level Country Musi to być wartość z zakresu OfficeLevel. Jeśli żaden z nich nie pasuje do Twojej sytuacji, skontaktuj się z osobą kontaktową w Google.
office-role upper house

Musi to być wartość z zakresu OfficeRole. Jeśli żaden z nich nie pasuje do Twojej sytuacji, skontaktuj się z osobą kontaktową w Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Użyj tej opcji, aby odróżnić biura z wieloma miejscami lub stanowiskami oraz biura, które nie są ograniczone do konkretnego okręgu i nie wygasły.

Przykłady

XML

    <Office objectId="off0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <JurisdictionId>ru-gpu0</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <Role>upper house</Role>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>