Richtlinien für Entwicklerdaten

Informationen zur Wahl

Die Google Civic Information API gibt Informationen zu Wahlen zurück, z. B. Wahllokale, Orte für die vorzeitige Stimmabgabe, Kontaktdaten von lokalen Wahlbeamten und Informationen zum Stimmzettel. Diese Informationen werden Nutzern für Wahlen zur Verfügung gestellt, die vom Voting Information Project unterstützt werden.

Datenverfügbarkeit

Richtlinien für Entwickler

Alle Entwickler müssen die folgenden Richtlinien einhalten:

  • Halten Sie sich an die API-Nutzungsbedingungen.
  • Durch die Verwendung der API stimmen Entwickler zu, alle Cache-Control-Header zu beachten, sofern vorhanden. Ohne Cache-Control-Header stimmen Entwickler zu, Wahllokale und Informationen zu Wahlen und Abstimmungen nicht länger als 24 Stunden und Amtsinhaber und Wahlbezirke nicht länger als 30 Tage zu cachen.
  • Entwickler, die die API verwenden, sollten alles tun, um sicherzustellen, dass alle Nutzer die gleiche Erfahrung machen. Holdbacks, A/B-Tests oder ähnliche Tests sind nicht zulässig.

  • Wenn Sie zusätzliches Kontingent für Ihren Anwendungsfall benötigen, können Sie in der Developer Console eine Erhöhung pro Projekt beantragen. Die Bereitstellung von zusätzlichem Kontingent ist begrenzt und unterliegt einer maximalen Zuteilung.

    Hinweis:Der Genehmigungsprozess dauert ein bis zwei Monate.Planen Sie Ihre Anfragen zur Kontingenterhöhung entsprechend. Wenn Sie eine Kontingenterhöhung für die US-Präsidentschaftswahlen 2024 benötigen,reichen Sie Ihre Kontingentanfragen bis August ein.

  • Zusätzliches Kontingent für die Civic Info API ist nur für nutzerorientierte Anwendungsfälle vorgesehen. Für andere Anwendungsfälle werden keine Anfragen zur Kontingenterhöhung gewährt.

Zusätzliche Datenrichtlinien

Die Verarbeitung dieser Daten ist besonders schwierig. Beachten Sie die folgenden Punkte.

  • Wahlbeamte überarbeiten diese Daten in den letzten Wochen und sogar in den letzten Tagen vor der Wahl häufig. Es ist eine gute Idee, Nutzer darauf hinzuweisen, dass sie vor der Abstimmung noch einmal nachsehen sollten.
  • Die meisten offiziellen Feeds enthalten Straßenabschnitte. Das bedeutet, dass Wahlhelfer eine Reihe von Adressen mit Wahlbezirken und Wahllokalen verknüpfen. In den Bereichen sind möglicherweise keine Wähler registriert. Daher kann für Bundesstaaten, die offizielle Feeds über das Voting Information Project bereitstellen, eine Adresse, an der keine Wähler registriert sind, ein Erfolg zurückgeben.
  • In Bundesstaaten, in denen kein offizieller Feed verfügbar ist, wird nur für Adressen, an denen ein registrierter Wähler wohnt, ein Erfolg zurückgegeben.
  • Manchmal haben wir mehrere Quellen für dieselben Informationen. Wir stellen die bestmöglichen Informationen zu Kontaktdaten von Wahlbeamten und zu Stimmzetteln bei Kommunalwahlen bereit. Dieses Verhalten lässt sich nur umgehen, indem Sie inoffizielle Quellen über den Parameter „officialSourcesOnly“ ausschließen. Bei Informationen zu Wahllokalen haben offizielle Datenquellen immer Vorrang vor anderen Quellen.
  • Wenn wir Probleme mit der Datenqualität feststellen, liefern wir möglicherweise keine Daten für einen bestimmten Wahlbezirk zurück, bis das Problem behoben ist.
  • Wenn wir keine Daten zu einer Adresse haben, bedeutet das nicht unbedingt, dass dort niemand wahlberechtigt ist. In Apps sollten Nutzer an die zuständigen Wahlbehörden weitergeleitet werden, um vollständige Informationen zu erhalten.
  • Wahlen laufen nach dem Wahltag automatisch ab. Danach werden keine Daten mehr für die Wahl zurückgegeben.

Attribution

Die Quellenangabe für die Civic Information API ist optional. Wenn ein Entwickler die Civic Information API als Quelle angibt und Nutzer auf weitere Informationen zur Civic Information API verweist, muss er eine der folgenden Formulierungen für die Quellenangabe und die unten verlinkte Webseite verwenden:

  • „Powered by the Civic Information API“
  • „Wahlinformationen basierend auf der Civic Information API“
  • „Wahlinformationen basierend auf der Civic Information API“
  • Weitere Informationen

Statuscodes

Aufrufe von voterInfoQuery enthalten das Feld status, das auf success gesetzt ist, wenn eine Adresse akzeptiert wird. In anderen Fällen wird ein Fehlercode zurückgegeben. Im Folgenden finden Sie häufige Erklärungen für Fehlercodes. Hinweis: Auch wenn ein Fehlercode vorhanden ist, können Informationen zurückgegeben werden.

Status Erklärung
success Die angeforderte Adresse wird von der API als gültige Adresse erkannt.
noStreetSegmentFound Die API enthält derzeit keine Informationen dazu, zu welchem Wahlbezirk und/oder Bezirk diese Adresse gehört. Möglicherweise werden noch neue Daten erhoben oder verarbeitet oder es gibt keine Wähler, die sich an dieser Adresse registriert haben.
addressUnparseable Die angeforderte Adresse ist nicht richtig formatiert oder kann nicht geocodiert werden (d.h., die Google Maps API kennt diese Adresse nicht).
noAddressParameter Es wurde keine Adresse angegeben.
multipleStreetSegmentsFound Die API kann keine Informationen zur angegebenen Adresse finden, hat aber Informationen zu Adressen in der Nähe. Der Nutzer sollte sich an die Wahlbehörde wenden, um weitere Informationen zu erhalten.
electionOver Die angeforderte Wahl ist vorbei. API-Ergebnisse für die Wahl sind nicht mehr verfügbar. Mit einer electionQuery können Sie die ID einer bevorstehenden Wahl ermitteln.
electionUnknown Die angeforderte Wahl-ID ist ungültig. Führen Sie eine electionQuery aus, um eine gültige ID zu finden.
internalLookupFailure Beim Verarbeiten der Anfrage ist ein unbekannter Fehler aufgetreten.