Wytyczne dla deweloperów dotyczące danych

Informacje o głosowaniu

Interfejs Google Civic Information API zwraca informacje o wyborach, takie jak miejsce głosowania, miejsce wczesnego głosowania, dane kontaktowe urzędnika wyborczego oraz informacje o karcie do głosowania dla użytkowników w przypadku wyborów obsługiwanych przez Voting Information Project.

Dostępność danych

Wskazówki dla programistów

Od wszystkich deweloperów wymagamy przestrzegania tych wytycznych:

  • Przestrzegaj warunków korzystania z interfejsów API.
  • Korzystając z interfejsu API, deweloperzy wyrażają zgodę na przestrzeganie nagłówków cache-control, jeśli takie istnieją. W przypadku braku nagłówków cache-control deweloperzy zgadzają się na nieprzechowywanie w pamięci podręcznej przez ponad 24 godziny informacji o miejscach głosowania i konkursach oraz przez ponad 30 dni informacji o posłach i okręgach wyborczych.
  • Deweloperzy korzystający z interfejsu API powinni dołożyć wszelkich starań, aby zapewnić wszystkim użytkownikom ten sam poziom obsługi. Nie zezwalamy na wstrzymanie, testy A/B ani podobne eksperymenty.

  • Jeśli potrzebujesz dodatkowej puli danych, aby umożliwić realizację Twojego przypadku użycia, możesz poprosić o zwiększenie limitu na projekt w Konsoli programisty. Przydzielanie dodatkowej puli jest ograniczone i podlega maksymalnemu limitowi.

    Uwaga: proces zatwierdzania trwa 1–2 miesiące.Odpowiednio planuj prośby o zwiększenie limitu. Aby przygotować się na zwiększenie limitu w 2024 roku,prześlij prośby o zwiększenie limitu do sierpnia.

  • Dodatkowa pula limitu dla interfejsu Civic Info API jest przeznaczona tylko do obsługi przypadków użycia obejmujących użytkowników. Wnioski o zwiększenie limitu nie są rozpatrywane w przypadku innych zastosowań.

Dodatkowe wytyczne dotyczące danych

Z tymi danymi trudno jest pracować. Pamiętaj o tych kwestiach.

  • W ostatnich tygodniach, a nawet w ostatnich dniach przed wyborami, urzędnicy wyborczy często zmieniają te dane. Warto ostrzec użytkowników, że powinni sprawdzić wyniki przed głosowaniem.
  • Większość oficjalnych plików danych zawiera segmenty ulic, co oznacza, że urzędnicy wyborczy przypisują zakres adresów do okręgów wyborczych i miejsc głosowania. W tych zakresach mogą być zarejestrowani wyborcy, ale nie muszą. W związku z tym w przypadku stanów, które udostępniają oficjalne kanały danych za pomocą projektu Voting Information Project, adres, pod którym nie ma zarejestrowanych wyborców, może zwrócić wartość true.
  • W przypadku stanów, które nie udostępniają oficjalnego pliku danych, tylko adresy, na których zarejestrowany jest wyborca, będą zwracać wartość sukcesu.
  • Czasami mamy wiele źródeł tych samych informacji. Udostępniamy informacje o najwyższej jakości dotyczące kontaktów z lokalnymi urzędami wyborczymi oraz informacje o kartach do głosowania. Nie ma możliwości zastąpienia tego zachowania, z wyjątkiem wyeliminowania nieoficjalnych źródeł za pomocą parametru officialSourcesOnly. W przypadku informacji o miejscach głosowania zawsze priorytetowo traktujemy oficjalne źródła danych.
  • Jeśli wykryjemy problemy z jakością danych, możemy nie zwracać żadnych danych dotyczących konkretnego okręgu wyborczego, dopóki problem nie zostanie rozwiązany.
  • Jeśli nie mamy danych o adresie, niekoniecznie oznacza to, że nikt tam nie jest zarejestrowany do głosowania. Aplikacje powinny kierować użytkowników do lokalnych urzędników wyborczych, którzy udzielą im pełnych informacji.
  • Wybory wygasają automatycznie po dniu wyborów. Po tym czasie nie będą zwracane żadne dane dotyczące tego wyboru.

Atrybucja

Przypisanie Civic Information API jest opcjonalne. Jeśli deweloper zdecyduje się przypisać autorstwo do interfejsu Civic Information API i przekierować użytkowników na stronę z dodatkowymi informacjami na temat tego interfejsu, musi użyć jednej z tych opcji języka przypisania i linku do strony internetowej:

  • „Oparte na Civic Information API”
  • „Informacje o głosowaniu z użyciem interfejsu Civic Information API”
  • „Informacje o głosowaniu z użyciem interfejsu Civic Information API”
  • „Więcej informacji”

Kody stanu

Wywołania funkcji voterInfoQuery zawierają pole status, które po zaakceptowaniu adresu jest ustawiane na success. W innych przypadkach zwracany jest kod błędu. Poniżej znajdziesz wyjaśnienia typowych kodów błędów. Pamiętaj, że informacje mogą zostać zwrócone nawet wtedy, gdy występuje kod błędu.

Stan Wyjaśnienie
success Żądany adres jest uznawany przez interfejs API za prawidłowy.
noStreetSegmentFound Interfejs API nie zawiera obecnie informacji o tym, do jakiego okręgu wyborczego lub okręgu wyborczego należy dany adres. Być może wciąż pobieramy lub przetwarzamy nowe dane albo nie ma żadnych wyborców zarejestrowanych pod tym adresem.
addressUnparseable Żądany adres jest nieprawidłowo sformatowany lub nie można go zgeokodować (tzn. interfejs Mapy Google API nie wie nic o tym adresie).
noAddressParameter Nie podano adresu.
multipleStreetSegmentsFound Interfejs API nie może znaleźć informacji o wybranym adresie, ale ma informacje o adresach w pobliżu. Aby uzyskać więcej informacji, użytkownik powinien skontaktować się z urzędnikiem wyborczym.
electionOver Wybrane wybory już się zakończyły. Wyniki wyborów dostępne w interfejsie API nie są już dostępne. Aby znaleźć identyfikator nadchodzących wyborów, wykonaj zapytanie electionQuery.
electionUnknown Identyfikator wyboru jest nieprawidłowy. Aby znaleźć prawidłowy identyfikator, wykonaj zapytanie electionQuery.
internalLookupFailure Podczas przetwarzania żądania wystąpił nieokreślony błąd.