Richtlinien für Entwicklerdaten

Informationen zur Abstimmung

Die Google Civic Information API gibt Nutzern Informationen zu Wahlen zurück, die vom Voting Information Project unterstützt werden. Dazu gehören Informationen zu Wahllokalen, Orten für vorzeitige Stimmabgabe, Kontaktdaten der örtlichen Wahlbehörden und Informationen zu Stimmzetteln.

Datenverfügbarkeit

Richtlinien für Entwickler

Alle Entwickler müssen die folgenden Richtlinien einhalten:

  • Beachten Sie die Nutzungsbedingungen der APIs.
  • Durch die Verwendung der API stimmen Entwickler zu, alle Cache-Kontroll-Header zu beachten, falls vorhanden. Wenn keine Cache-Kontroll-Header vorhanden sind, erklären sich Entwickler damit einverstanden, Informationen zu Wahlorten und Wahlen nicht länger als 24 Stunden und Informationen zu Amtsinhabern und Wahlbezirken nicht länger als 30 Tage im Cache zu speichern.
  • Entwickler, die die API verwenden, sollten sich bemühen, allen Nutzern die gleiche Erfahrung zu bieten. Holdbacks, A/B-Tests oder ähnliche Tests sind nicht zulässig.

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

    Hinweis:Die Genehmigung dauert ein bis zwei Monate.Planen Sie Ihre Anträge auf Kontingenterhöhung entsprechend. Reichen Sie bis August Kontingentanfragen ein,um sich auf die Kontingenterhöhungen für die Präsidentschaftswahlen 2024 vorzubereiten.

  • Das zusätzliche Kontingent für die Civic Info API ist nur für Nutzer-Anwendungsfälle vorgesehen. Anfragen zur Kontingenterhöhung werden für andere Anwendungsfälle nicht gewährt.

Zusätzliche Datenrichtlinien

Die Arbeit mit diesen Daten ist besonders schwierig. Beachten Sie dabei Folgendes:

  • Wahlbehörden überarbeiten diese Daten oft in den letzten Wochen und sogar in den letzten Tagen vor der Wahl. Es ist empfehlenswert, Nutzer darauf hinzuweisen, dass sie vor dem Abstimmen noch einmal nachsehen sollten.
  • Die meisten offiziellen Feeds enthalten Straßensegmente. Das bedeutet, dass Wahlhelfer eine Reihe von Adressen mit Wahlbezirken und Wahllokalen verknüpfen. In den Bereichen sind möglicherweise Wähler registriert. Daher kann für Bundesländer, die offizielle Feeds über das Voting Information Project bereitstellen, eine Adresse, an der keine registrierten Wähler gemeldet sind, als erfolgreich zurückgegeben werden.
  • Für Bundesstaaten, die keinen offiziellen Feed bereitstellen, wird nur für Adressen, an denen ein registrierter Wähler gemeldet ist, ein Erfolg zurückgegeben.
  • Gelegentlich haben wir mehrere Quellen für dieselben Informationen. Wir stellen die hochwertigsten Informationen zu den offiziellen Kontaktdaten und Stimmzetteln für lokale Wahlen zur Verfügung. Dieses Verhalten lässt sich nicht überschreiben. Sie können nur nicht offizielle Quellen über den Parameter „officialSourcesOnly“ entfernen. Bei Informationen zu Wahllokalen haben offizielle Datenquellen immer Vorrang vor anderen Quellen.
  • Wenn wir Probleme mit der Datenqualität feststellen, werden für einen bestimmten Wahlbezirk möglicherweise keine Daten zurückgegeben, bis das Problem behoben ist.
  • Wenn wir keine Daten zu einer Adresse haben, bedeutet das nicht unbedingt, dass dort niemand zur Wahl registriert ist. Nutzer sollten in Apps zu den 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 Angabe der Civic Information API ist optional. Wenn ein Entwickler die Civic Information API zuordnen und Nutzer zu weiteren Informationen zur Civic Information API weiterleiten möchte, muss er eine der folgenden Optionen für die Sprache der Quellenangabe und die unten verlinkte Webseite verwenden:

  • „Mit der Civic Information API“
  • „Informationen zur Wahl, bereitgestellt von der Civic Information API“
  • „Informationen zu Wahlvorschlägen, bereitgestellt von der Civic Information API“
  • Weitere Informationen

Statuscodes

Aufrufe von voterInfoQuery enthalten ein status-Feld, das auf success gesetzt wird, 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: Informationen können auch dann zurückgegeben werden, wenn ein Fehlercode vorhanden ist.

Status Erklärung
success Die angeforderte Adresse wird von der API als gültig erkannt.
noStreetSegmentFound Die API enthält derzeit keine Informationen dazu, zu welchem Wahlbezirk und/oder Wahlkreis diese Adresse gehört. Möglicherweise sind wir noch dabei, neue Daten zu erheben und zu verarbeiten, oder es gibt keine Wähler, die sich an dieser Adresse für die Wahl 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 für die angegebene Adresse finden, aber es gibt Informationen zu Adressen in der Nähe. Weitere Informationen erhalten Sie von den Wahlbehörden.
electionOver Die angefragte Wahl ist vorbei. API-Ergebnisse für die Wahl sind nicht mehr verfügbar. Führe eine electionQuery aus, um eine ID für eine anstehende Wahl zu finden.
electionUnknown Die angeforderte Wahl-ID ist ungültig. Führe eine electionQuery aus, um eine gültige ID zu finden.
internalLookupFailure Bei der Verarbeitung der Anfrage ist ein nicht näher beschriebener Fehler aufgetreten.