Geografia polityczna i wybrani przedstawiciele
Google Civic Information API oferuje informacje o politycznych działach geograficznych i wybranych przedstawicielach w przypadku adresów w USA – od federalnych do lokalnych. Obecnie mamy zasięg w okręgach stanowych, hrabstwach i kongresowych, a w stanowych okręgach ustawodawczych 90% ma zasięg. Niższe poziomy, takie jak rady miejskie i powiatowe, są obsługiwane w miarę możliwości i z czasem będą się poprawiać.
Oczekujemy aktualnych informacji o wszystkich urzędnikach federalnych, stanowych i hrabstwach, a także o urzędnikach miejskich w największym mieście w każdym stanie USA, a także o miastach liczących więcej niż 250 tysięcy mieszkańców. Zbieramy te dane z wielu źródeł i udostępniamy informacje najwyższej jakości. Jeśli wykryjemy problemy z jakością danych, możemy przestać przekazywać dane dotyczące określonych oddziałów geograficznych, urzędników lub urzędników państwowych.
Informacje na temat głosowania
Google Civic Information API zwraca użytkownikom dane o wyborach uwzględnianych w wyborach wspieranych przez Voting Information Project, np. miejsce głosowania, informacje o miejscu wcześniejszego głosowania, dane kontaktowe urzędników lokalnych i informacje o kartach do głosowania.
Dostępność danych
- Kalendarz wyborów na rok 2024 (Voting Information Project) zawiera informacje na temat oczekiwanych relacji z wyborami, które zostaną opublikowane w interfejsie Google Civic Information API.
Wskazówki dla deweloperów
Wymagamy od wszystkich deweloperów przestrzegania tych wytycznych:
- Przestrzegasz warunków korzystania z interfejsów API.
- Korzystając z tego interfejsu API, deweloperzy zgadzają się przestrzegać wszelkich nagłówków kontroli pamięci podręcznej, jeśli istnieją. W przypadku braku nagłówków służących do kontroli pamięci podręcznej deweloperzy zobowiązują się nie przechowywać w pamięci podręcznej przez ponad 24 godziny w przypadku miejsc głosowania i informacji o konkursach, a ponad 30 dni w przypadku urzędników i okręgów.
- Deweloperzy korzystający z interfejsu API powinni dołożyć wszelkich starań, aby wrażenia użytkowników były takie same. Nie zezwalamy na izolacje, testy A/B ani podobne eksperymenty.
Jeśli potrzebujesz dodatkowego limitu na potrzeby swojego przypadku użycia, w konsoli programisty możesz poprosić o zwiększenie limitu dla poszczególnych projektów. Udostępnianie dodatkowego limitu jest ograniczone i podlega maksymalnej dopuszczalnej wartości.
Uwaga: proces zatwierdzania trwa 1–2 miesiące.Odpowiednio zaplanuj prośby o zwiększenie limitu. Aby przygotować się na zwiększenie limitu wyborów prezydenckich w 2024 roku,prześlij prośby o zwiększenie limitu do sierpnia.
- Dodatkowy limit dla interfejsu Civic Info API jest przeznaczony tylko do obsługi użytkowników. Prośby o zwiększenie limitu nie są przyznawane w innych przypadkach użycia.
Dodatkowe wytyczne dotyczące danych
Korzystanie z tych danych jest szczególnie trudne. Pamiętaj o następujących kwestiach.
- Urzędnicy wyborcy często korygują te dane w ciągu ostatnich kilku tygodni, a nawet kilku ostatnich dni przed wyborami. Warto ostrzec użytkowników, że powinni sprawdzić ponownie przed oddaniem głosu.
- Większość oficjalnych plików danych zawiera segmenty z ulicami, co oznacza, że komisja wyborcza łączy zakresy adresów z obrębami okręgów i lokalami wyborczymi. Mogą one obejmować (ale nie muszą) wyborców zarejestrowanych pod tym adresem. Oznacza to, że w przypadku stanów, które dostarczają oficjalne kanały w ramach projektu Voting Information Project, adres, pod którym nie ma zarejestrowanych wyborców, może zwrócić sukces.
- W przypadku stanów, w których nie ma oficjalnego pliku danych, wyniki będą wskazywać tylko te adresy, pod którymi zarejestrowany jest wyborca.
- Czasami dysponujemy wieloma źródłami tych samych informacji. Udostępniamy najwyższej jakości informacje dostępne w przypadku oficjalnych danych kontaktowych dotyczących wyborów i danych kart do głosowania. Nie ma innego sposobu na zastąpienie tego działania innym niż wykluczenie nieoficjalnych źródeł za pomocą parametruOfficialSourcesOnly. W przypadku informacji o punktach wyborczych zawsze traktujemy oficjalne źródła danych w pierwszej kolejności.
- Jeśli wykryjemy problemy z jakością danych, możemy nie zwracać żadnych danych dla danego okręgu wyborczego do czasu rozwiązania problemu.
- Jeśli nie mamy danych na temat adresu, nie musi to oznaczać, że nie ma nikogo, kto może głosować pod tym adresem. Aplikacje powinny kierować użytkowników do lokalnych urzędników wyborczych w celu uzyskania pełnych informacji.
- Wybory automatycznie tracą ważność po dniu wyborów. Od tego momentu nie będą już zwracane żadne dane dotyczące wyborów.
Atrybucja
Atrybucja Civic Information API jest opcjonalna. Jeśli deweloper zdecyduje się przypisać udział w interfejsie Civic Information API i umieścić linki do dodatkowych informacji o Civic Information API, deweloperzy będą musieli użyć jednej z następujących opcji językowych i stron internetowych, do których link znajduje się poniżej:
- „Powered by the Civic Information API”
- „Informacje wyborcze obsługiwane przez Civic Information API”
- „Ballot information powered by the Civic Information API”
- „Informacje reprezentatywne dostarczane przez Civic Information API”
- Więcej informacji
Kody stanu
Wywołania funkcji voterInfoQuery zawierają pole status, które ma wartość success, gdy adres jest akceptowany. W pozostałych przypadkach zwrócony zostanie kod błędu. Poniżej znajdziesz typowe wyjaśnienia kodów błędów. Pamiętaj, że informacje mogą zostać zwrócone nawet wtedy, gdy podano kod błędu.
| Stan | Wyjaśnienie |
|---|---|
success |
Żądany adres jest rozpoznawany przez interfejs API jako prawidłowy. |
noStreetSegmentFound |
Obecnie interfejs API nie ma informacji o okręgu wyborczym lub okręgu, do którego należy ten adres. Być może nadal zbieramy/przetwarzamy nowe dane albo że nie ma wyborców, którzy zarejestrowali się na głosowanie pod tym adresem. |
addressUnparseable |
Żądany adres ma nieprawidłowy format lub nie może zostać zakodowany geograficznie (np. interfejs API Map Google nie wie nic o tym adresie). |
noAddressParameter |
Nie podano adresu. |
multipleStreetSegmentsFound |
Interfejs API nie może znaleźć informacji o podanym adresie, ale zawiera informacje o pobliskich adresach. Użytkownik powinien skontaktować się z komisarzem wyborczym, aby uzyskać więcej informacji. |
electionOver |
Wybrane wybory dobiegły końca. Wyniki wyborów w interfejsie API nie są już dostępne. Przeprowadź electionQuery, aby znaleźć identyfikator dotyczący nadchodzących wyborów. |
electionUnknown |
Żądany identyfikator wyborów jest nieprawidłowy. Aby znaleźć prawidłowy identyfikator, wykonaj polecenie electionQuery. |
internalLookupFailure |
Podczas przetwarzania żądania wystąpił nieokreślony błąd. |