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:
|
|
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:
|
|
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.