Richtlinien für Entwicklerdaten

Politische Geografie und gewählte Vertreter

Die Google Civic Information API bietet Informationen zu politischen geografischen Unterteilungen und gewählten Vertretern für US-Adressen von bundesstaatlicher bis lokaler Ebene. Derzeit haben wir Abdeckung von fast 100% für bundesstaatliche, County- und Kongressbezirke mit einer Abdeckung von über 90% für die gesetzgebenden Wahlbezirke auf bundesstaatlicher Ebene. Niedrigere Ebenen, wie Stadt- und Landkreisräte, werden nach Best-Effort-Basis bedient und werden im Laufe der Zeit immer besser.

Wir erwarten aktuelle Informationen zu allen gewählten Amtsträgern auf Bundes-, Landes- und Landkreisebene, zu Stadtbeamten für die größte Stadt in jedem US-Bundesstaat sowie zu allen Städten mit einer Bevölkerung mit mehr als 250.000 Einwohnern. Wir aggregieren diese Daten aus mehreren Quellen und stellen die qualitativ hochwertigsten verfügbaren Informationen zur Verfügung. Wenn wir Probleme mit der Datenqualität feststellen, können wir die Rückgabe von Daten für bestimmte Regionen, öffentliche Ämter oder gewählte Amtsträger einstellen.

Informationen zur Abstimmung

Die Google Civic Information API gibt bei Wahlen, die vom Voting Information Project unterstützt werden, Bürgerinformationen wie Wahllokale, Ort der vorzeitigen Stimmabgabe, Kontaktdaten von Kommunalwahlbeamten und Stimmzettelinformationen an Nutzer zurück.

Datenverfügbarkeit

Richtlinien für Entwickler

Alle Entwickler müssen die folgenden Richtlinien einhalten:

  • Sie müssen die Nutzungsbedingungen der APIs einhalten.
  • Durch die Verwendung der API stimmen Entwickler zu, etwaige Cache-Control-Header zu beachten, sofern vorhanden. Ohne Cache-Kontroll-Header erklären sich die Entwickler damit einverstanden, nicht länger als 24 Stunden für Wahllokale und Wettbewerbsinformationen im Cache und für Amtsträger und Wahlbezirke mehr als 30 Tage im Cache zu speichern.
  • Entwickler, die die API verwenden, sollten alles tun, um sicherzustellen, dass alle Nutzer die gleiche Erfahrung haben. Holdbacks, A/B-Tests und ähnliche Tests sind nicht zulässig.

  • Wenn Sie ein zusätzliches Kontingent benötigen, um Ihren Anwendungsfall zu aktivieren, können Sie in der Developer Console eine Erhöhung pro Projekt beantragen. Die Bereitstellung zusätzlicher Kontingente ist begrenzt und unterliegt einem maximalen Kontingent.

    Hinweis:Der Genehmigungsprozess dauert ein bis zwei Monate.Planen Sie Ihre Anfragen zur Kontingenterhöhung entsprechend. Wenn Sie sich auf die Erhöhung des Kontingents für die Präsidentschaftswahlen 2024 vorbereiten möchten,müssen Sie bis August Kontingentanfragen einreichen.

  • Das zusätzliche Kontingent für die Civic Info API ist nur für nutzerseitige Anwendungsfälle vorgesehen. Für andere Anwendungsfälle werden keine Anfragen zur Kontingenterhöhung genehmigt.

Zusätzliche Datenrichtlinien

Der Umgang mit diesen Daten ist besonders schwierig. Beachten Sie die folgenden Punkte.

  • Wahlbehörden überarbeiten diese Daten häufig in den letzten Wochen und sogar in den letzten Tagen vor der Wahl. Es ist eine gute Idee, die Nutzenden darauf hinzuweisen, dass sie vor der Abstimmung noch einmal vorbeischauen sollten.
  • Die meisten offiziellen Feeds enthalten Straßenabschnitte. Das bedeutet, dass Wahlbeamte mehrere Adressen mit Wahlbezirken und Wahllokalen verknüpfen. Für die Bereiche können Wähler unter diesen Adressen registriert sein. Bei Bundesstaaten, die über das Voting Information Project offizielle Feeds bereitstellen, kann eine Adresse, an der keine Wähler registriert sind, einen Erfolg zurückgeben.
  • Bei Bundesstaaten, die keinen offiziellen Feed anbieten, werden nur Adressen gemeldet, an denen es einen registrierten Wähler gibt.
  • Gelegentlich stehen uns mehrere Quellen für dieselben Informationen zur Verfügung. Wir liefern die qualitativ hochwertigsten Informationen, die für Kontaktinformationen und Informationen zum Stimmzettel von lokalen Wahlbehörden verfügbar sind. Dieses Verhalten kann nur überschrieben werden, um inoffizielle Quellen über den Parameter „OfficialSourcesOnly“ zu entfernen. Bei Informationen zu Wahllokalen priorisieren wir immer offizielle Datenquellen gegenüber anderen Quellen.
  • Wenn wir Probleme mit der Datenqualität feststellen, geben 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 zwangsläufig, dass dort niemand für die Stimmabgabe registriert ist. Anträge sollten den Nutzer an die für Sie zuständigen Wahlbeauftragten weiterleiten, um vollständige Informationen zu erhalten.
  • Die Wahl läuft automatisch nach dem Wahltag ab. Danach werden keine Daten für die Wahl mehr zurückgegeben.

Attribution

Die Angabe der Civic Information API ist optional. Wenn sich ein Entwickler für die Civic Information API entscheidet und Nutzer auf weitere Informationen über die Civic Information API verweist, müssen Entwickler eine der folgenden Optionen für die Attributionssprache und die unten verlinkte Webseite verwenden:

  • „Unterstützt von der Civic Information API“
  • „Abstimmungsinformationen auf Basis der Civic Information API“
  • „Ballot-Informationen mit der Civic Information API“
  • „Repräsentative Informationen, die von der Civic Information API unterstützt werden“
  • „Weitere Informationen“

Statuscodes

Aufrufe von voterInfoQuery enthalten das Feld status, das auf success gesetzt wird, wenn eine Adresse akzeptiert wird. In anderen Fällen wird ein Fehlercode zurückgegeben. Allgemeine Erklärungen zu Fehlercodes finden Sie unten. Hinweis: Informationen können auch zurückgegeben werden, wenn ein Fehlercode vorhanden ist.

Status Erklärung
success Die angeforderte Adresse wird von der API als gültige Adresse erkannt.
noStreetSegmentFound Die API verfügt derzeit über keine Informationen darüber, zu welchem Wahlbezirk und/oder Bezirk diese Adresse gehört. Es kann sein, dass wir noch neue Daten beschaffen bzw. verarbeiten oder dass sich keine Wähler unter dieser Adresse für die Stimmabgabe registriert haben.
addressUnparseable Die angeforderte Adresse ist nicht richtig formatiert oder kann nicht geocodiert werden (d.h. das Google Maps-API hat keine Informationen zu dieser Adresse).
noAddressParameter Es wurde keine Adresse angegeben.
multipleStreetSegmentsFound Die API kann keine Informationen zur angegebenen Adresse finden, enthält aber Informationen zu Adressen in der Nähe. Weitere Informationen erhalten Sie vom Wahlbeauftragten.
electionOver Die erbetene Wahl ist vorbei. API-Ergebnisse für die Wahl sind nicht mehr verfügbar. Erstellen Sie eine electionQuery, um eine ID für eine anstehende Wahl zu ermitteln.
electionUnknown Die angeforderte Wahl-ID ist ungültig. Erstellen Sie eine electionQuery, um eine gültige ID zu ermitteln.
internalLookupFailure Bei der Verarbeitung der Anfrage ist ein unbekannter Fehler aufgetreten.