Representatives

Ta kolekcja zawiera informacje o geografii politycznej, a także informacje o urzędnikach państwowych.

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Zasób w tej kolekcji składa się z 3 sekcji, które zostały szczegółowo opisane poniżej. Sekcja divisions zawiera listę jednostek administracyjnych politycznych, takich jak kraj, stan, hrabstwo lub okręg wyborczy. To, które oddziały zostaną wyświetlone, zależy od konkretnego żądania do interfejsu API. Sekcja offices zawiera listę stanowisk politycznych wybieranych do reprezentowania oddziałów z 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 Open Civic Data dla danego działu.
divisions.(key).alsoKnownAs[] list Wszelkie inne prawidłowe identyfikatory OCD odnoszące się do tego samego podziału.

Identyfikatory OCD powinny być zrozumiałe dla człowieka i co najmniej w ogóle przewidywalne, dlatego czasami w przypadku pojedynczego działu może się pojawić kilka identyfikatorów. Identyfikatory te są zdefiniowane jako równoważne sobie i jeden z nich jest zawsze wskazywany jako identyfikator główny. Podstawowy identyfikator zostanie zwrócony w wartości ocd_id powyżej, a wszystkie inne równoważne prawidłowe identyfikatory zostaną zwrócone na tę listę.

Jeśli na przykład identyfikator OCD tego działu to ocd-division/country:pl/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 na każdy urząd wybrany z tego działu. Ten parametr będzie występować tylko wtedy, gdy żądanie includeOffices ma wartość prawda (lub nie ma go w żądaniu).

Wybrane urzędy

Nazwa usługi Wartość Opis Uwagi
offices[] list Wybrane urzędy, do których odnoszą się wymienione wyżej oddziały. Będzie obecny tylko wtedy, gdy parametr includeOffices ma w żądaniu wartość true (prawda).
offices[].divisionId string Identyfikator OCD działu, z którym powiązane jest to biuro.
offices[].levels[] list Poziomy rządu, do których należy to biuro. W sytuacjach, w których dana jurysdykcja faktycznie działa na 2 różnych szczeblach władzy, może mieć więcej niż jeden przypadek. na przykład burmistrz Dystryktu Kolumbii występuje w „rejonie”. na poziomie konta, ale również na poziomie administrativeArea2 i administrativeArea1.

Prawidłowe wartości to m.in.:
  • international – rządy międzynarodowe, np. Organizacja Narodów Zjednoczonych lub Unia Europejska.
  • country – instytucje państwowe, np. rząd federalny Stanów Zjednoczonych.
  • administrativeArea1 – rządy najwyższego poziomu podziału administracyjnego kraju, np. stanów w USA.
  • regional – władze regionalne, których jurysdykcja może przekraczać standardowe podziały administracyjne; W Stanach Zjednoczonych jest to rzadkie, ale powszechne w dużych miastach w innych krajach.
  • administrativeArea2 – rządy drugiego poziomu podziału administracyjnego kraju, np. hrabstwa w Stanach Zjednoczonych.
  • locality – samorządy miejskie lub miejskie.
  • subLocality1 – rządy najwyższego poziomu administracyjnego podziału miasta, np. okręgów w Waszyngtonie.
  • subLocality2 – rządy okręgu administracyjnego drugiego poziomu, np. Doradcze Radów Okręgowych w Waszyngtonie.
  • special – okręgi lokalne, które istnieją wyłącznie na potrzeby administracji rządowej przeznaczonej do celów specjalnych, np. okręgi zajmujące się ochroną gleby i wody.
offices[].name string Czytelna dla człowieka nazwa biura.
offices[].officialIndices[] list Lista indeksów w tablicy zawierającej osoby, które obecnie sprawują ten urząd.
offices[].roles[] list Role, jakie zajmuje to biuro. Role nie powinny być wyczerpujące ani dokładnie określać całego zakresu obowiązków osób na danym stanowiskach. Są to tylko ogólne kategorie przydatne podczas ogólnego wyboru stanowiska lub sortowania pod nim.

Prawidłowe wartości to m.in.:
  • headOfState – główny przedstawiciel rządu. Głowa państwa jest zwykle nazywana prezydentem.
  • headOfGovernment – prezes rządu. W Stanach Zjednoczonych jest to prezydent; w innych krajach jest to często premier. Na niższych poziomach może to być gubernator lub burmistrz.
  • deputyHeadOfGovernment – urzędnik odpowiedzialny za objęcie stanowiska szefa rządu w przypadku śmierci lub niepełnosprawności członka zarządu. W Stanach Zjednoczonych jest to wiceprezes. Ten urząd może mieć też inne obowiązki.
  • governmentOfficer – wybrana urzędnik władzy wykonawczej. W stanach USA może to być na przykład adwokat generalny, audytor, sekretarz, stan lub skarbnik.
  • executiveCouncil – członek rady wykonawczej, który pełni funkcje we współpracy z podmiotami zarządzającymi jako grupa. Przykładami są komisarze hrabstwa Indiana.
  • legislatorUpperBody – członek górnego organu dwuizbowego organu ustawodawczego lub jedyny organ organu ustawodawczego jednoizbowego organu ustawodawczego.
  • legislatorLowerBody – członek niższego oddziału dwuizbowego organu ustawodawczego.
  • highestCourtJudge – sąd najwyższego poziomu w konkretnym rządzie (np. stanowy Sąd Najwyższy).
  • judge – sędzia dowolnego sądu innego niż sąd najwyższego poziomu rządu, do którego służy.
  • schoolBoard – członek lokalnej rady szkoły.
  • specialPurposeOfficer – pracownik, który pełni określoną funkcję, np. członek rady ochrony gleby i wody lub specjalista ds. zwalczania komarów.
offices[].sources[] list Lista źródeł dla tego biura. Jeśli podasz wiele źródeł, dane zostaną zagregowane z tych źródeł.
offices[].sources[].name string Nazwa źródła danych.
offices[].sources[].official boolean Wskazuje, czy dane pochodzą z oficjalnego źródła rządowego.

Wybrani urzędnicy

Nazwa usługi Wartość Opis Uwagi
officials[] list Urzędnicy obsługujący urzędy wymienione powyżej. Będzie obecny tylko wtedy, gdy parametr includeOffices ma wartość prawda w żądaniu.
officials[].address[] list Adresy, pod którymi można się kontaktować z urzędnikiem.
officials[].address[].city string Miejscowość, w której znajduje się adres.
officials[].address[].line1 string Nazwa ulicy i numer tego adresu.
officials[].address[].line2 string W drugim wierszu (w razie potrzeby) wpisz adres.
officials[].address[].line3 string W razie potrzeby trzeci wiersz adresu.
officials[].address[].locationName string Nazwa lokalizacji.
officials[].address[].state string Dwuliterowy skrót adresu stanu w Stanach Zjednoczonych.
officials[].address[].zip string Kod pocztowy w Stanach Zjednoczonych powiązany z adresem.
officials[].channels[] list Lista znanych kanałów (w mediach społecznościowych) tego urzędnika.
officials[].channels[].id string Unikalny publiczny identyfikator kanału kandydata.
officials[].channels[].type string Typ kanału. Poniżej znajduje się lista typów kanałów, ale nie jest ona wyczerpująca. Później 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 grupy, do której należy urzędnik.
officials[].phones[] list Kontaktowe numery telefonów urzędnika.
officials[].photoUrl string Adres URL zdjęcia urzędnika.
officials[].urls[] list Adresy URL publicznej witryny oficjalnej strony internetowej.

Metody

representativeInfoByAddress
Wyszukiwanie informacji na temat położenia geograficznego oraz informacji reprezentatywnych dla pojedynczego adresu.
representativeInfoByDivision
Wyszukiwanie reprezentatywnych informacji dla pojedynczego działu geograficznego.