Representatives

Ta kolekcja zawiera informacje dotyczące geografii politycznej, a także informacji dotyczących urzędników państwowych.

Listę metod stosowanych w przypadku tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Zasób w tej kolekcji składa się z 3 sekcji opisanych poniżej. Sekcja divisions zawiera listę jednostek administracyjnych, np. krajów, stanów, hrabstw czy okręgów legislacyjnych. Podziały na liście zależą od konkretnego żądania do interfejsu API. Sekcja offices zawiera listę stanowisk politycznych wybranych w wyborach do reprezentowania poszczególnych oddziałów w pierwszej sekcji. Sekcja officials zawiera listę osób, które obecnie pracują w wymienionych biurach.

{
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}

Geografia polityczna

nazwa usługi, Wartość Opis Uwagi
divisions object Polityczne jednostki geograficzne, które zawierają żądany adres.
divisions.(key) nested object Unikalny identyfikator otwartych danych obywatelskich dla tego działu.
divisions.(key).alsoKnownAs[] list Wszelkie inne prawidłowe identyfikatory OCD, które odnoszą się do tego samego działu.

Identyfikatory OCD muszą być czytelne dla człowieka, a przynajmniej w pewnym stopniu przewidywalne. W przypadku jednego działu czasami istnieje kilka identyfikatorów. Identyfikatory te są zdefiniowane jako równoważne sobie nawzajem i jeden z nich jest zawsze wskazywany jako identyfikator główny. Główny identyfikator zostanie zwrócony w parametrze ocd_id powyżej, a wszelkie inne równoważne prawidłowe identyfikatory zostaną zwrócone na tej liście.

Jeśli na przykład identyfikator OCD tego działu to ocd-division/country:us/district:dc, będzie zawierać ocd-division/country:us/state:dc.
divisions.(key).name string Nazwa działu.
divisions.(key).officeIndices[] list Lista indeksów w tablicy offices, po jednym dla każdego urzędu wybranego z tego działu. Występuje tylko wtedy, gdy w żądaniu parametr includeOffices był prawdziwy (lub go nie było).

Wybrane biura

nazwa usługi, Wartość Opis Uwagi
offices[] list Wybrane urzędy, do których odwołują się wymienione powyżej działy. Jest widoczny tylko wtedy, gdy w żądaniu element includeOffices ma wartość true (prawda).
offices[].divisionId string Identyfikator OCD oddziału, z którym powiązane jest to biuro.
offices[].levels[] list Poziomy rządu, w którego skład wchodzą to urzęd. Może być kilka przypadków, gdy jurysdykcja faktycznie działa na dwóch różnych szczeblach władzy, np. burmistrz Dystryktu Kolumbii działa na poziomie „rejonu”, ale także w efekcie zarówno na poziomie administrativeArea2, jak i administrativeArea1.

Prawidłowe wartości to: 
  • international – rządy międzynarodowe, takie jak Organizacja Narodów Zjednoczonych lub Unia Europejska.
  • country – rządy krajowe, np. rząd federalny Stanów Zjednoczonych.
  • administrativeArea1 – rządy jednostki administracyjnej najwyższego poziomu kraju, takie jak stany w USA.
  • regional – rządy regionalne, których jurysdykcja może obejmować standardowe jednostki administracyjne; występują one rzadko w Stanach Zjednoczonych, ale są powszechne w dużych miastach w innych krajach.
  • administrativeArea2 – Rządy jednostki administracyjnej drugiego poziomu kraju, takie jak hrabstwa w USA.
  • locality – władze miejskie lub gminne.
  • subLocality1 – Rządy najwyższego poziomu jednostki administracyjnej miasta, np. Waszyngton, D.C..
  • subLocality2 – Rządy jednostki administracyjnej drugiego poziomu miasta, takie jak Doradcze Rady Sąsiedztwa Waszyngtonu.
  • special – okręgi lokalne, które istnieją wyłącznie dla instytucji państwowych o specjalnych celach, takich jak okręgi ochrony gleby i wody.
offices[].name string Czytelna dla człowieka nazwa biura.
offices[].officialIndices[] list Lista indeksów w tablicy oficjalnych osób, które obecnie sprawują to stanowisko.
offices[].roles[] list Role, jakie pełnią w tym biurze. Role nie są wyczerpujące ani nie mają dokładnego określenia całego zbioru obowiązków danego urzędu. Są to raczej kategorie ogólne, które są przydatne podczas wybierania odpowiednich stanowisk lub sortowania ich z listy.

Prawidłowe wartości to między innymi:
  • headOfState – główny publiczny przedstawiciel rządu. Głową państwa zazwyczaj nazywa się prezydentem.
  • headOfGovernment – dyrektor generalny rządu. W Stanach Zjednoczonych jest on prezydentem, a w innych krajach często premierem. Na niższych poziomach może to być gubernator lub burmistrz.
  • deputyHeadOfGovernment – urzędnik odpowiedzialny za przyjęcie roli szefa rządu w przypadku śmierci lub niepełnosprawności wybranego szefa rządu. W Stanach Zjednoczonych jest to wiceprezes. Ten urząd może też mieć inne obowiązki.
  • governmentOfficer – wybrany członek zarządu. W stanach USA może to obejmować role prokuratora generalnego, inspektora, sekretarza, sekretarza stanu lub skarbnika.
  • executiveCouncil – członek rady wykonawczej pełniący funkcje kierownicze jako grupa. Przykłady obejmują komisarzy hrabstwa Indiana.
  • legislatorUpperBody – członek najwyższego organu dwuizbowego organu ustawodawczego lub jedynego organu jednoizbowego legislatury.
  • legislatorLowerBody – członek niższego ciała dwuizbowego legislatury.
  • highestCourtJudge – sąd najwyższego sądu konkretnego rządu, np. Sąd Najwyższy.
  • judge – sędzia z dowolnego sądu innego niż sąd najwyższego państwa, w którym działa;
  • schoolBoard – członek lokalnej rady szkoły.
  • specialPurposeOfficer – urzędnik mający określony cel, np. członek rady ochrony gleby i wody lub funkcjonariusza ds. zwalczania komarów.
offices[].sources[] list Lista źródeł tego biura. Jeśli na liście znajduje się wiele źródeł, dane zostały z nich zagregowane.
offices[].sources[].name string Nazwa źródła danych.
offices[].sources[].official boolean Czy dane pochodzą z oficjalnego źródła rządowego.

Urzędnicy wybrani

nazwa usługi, Wartość Opis Uwagi
officials[] list Urzędnicy zarządzający biurami wymienionymi powyżej. Jest widoczny tylko wtedy, gdy w żądaniu element includeOffices ma wartość true (prawda).
officials[].address[] list Adresy, pod którymi można skontaktować się z urzędnikiem.
officials[].address[].city string Miasto lub miejscowość dla adresu.
officials[].address[].line1 string Nazwa ulicy i numer tego adresu.
officials[].address[].line2 string Drugi wiersz adresu (w razie potrzeby).
officials[].address[].line3 string Trzeci wiersz adresu, jeśli jest potrzebny.
officials[].address[].locationName string Nazwa lokalizacji.
officials[].address[].state string Dwuliterowy skrót adresu w Stanach Zjednoczonych.
officials[].address[].zip string Kod pocztowy adresu w Stanach Zjednoczonych.
officials[].channels[] list Lista znanych (społecznościowych) kanałów związanych z danym oficjalnym dokumentem.
officials[].channels[].id string Niepowtarzalny publiczny identyfikator kanału kandydata.
officials[].channels[].type string Typ kanału. Oto lista typów kanałów, ale nie jest ona wyczerpująca. W późniejszym czasie możemy dodać więcej typów kanałów. Jedna z tych możliwości: YouTube, Facebook, Twitter
officials[].emails[] list Bezpośrednie adresy e-mail urzędnika.
officials[].name string Imię i nazwisko urzędnika.
officials[].party string Pełna nazwa partii, do której należy dany urzędnik.
officials[].phones[] list Publiczne numery telefonów urzędników.
officials[].photoUrl string Adres URL zdjęcia urzędnika.
officials[].urls[] list Adresy URL publicznych witryn urzędnika.

Metody

representativeInfoByAddress
Przeszukuje dane geograficzne i informacje reprezentatywne dla pojedynczego adresu.
representativeInfoByDivision
Wyszukiwanie reprezentatywnych informacji dla danego działu geograficznego.