Consignes pour les données destinées aux développeurs

Géographie politique et représentants élus

L'API Google Civic Information fournit des informations sur les divisions géographiques et les élus politiques pour les adresses aux États-Unis, du niveau fédéral au local. À l'heure actuelle, notre couverture est d'environ 100% pour les circonscriptions d'État, de comtés et du Congrès, et nous visons à dépasser 90% pour les circonscriptions législatives d'État. Les niveaux inférieurs, tels que les conseils de ville et de comté, sont traités dans la mesure du possible et s'améliorent au fil du temps.

Nous prévoyons de disposer d'informations à jour sur tous les élus au niveau fédéral, de l'État et du comté, ainsi que sur les représentants municipaux de la plus grande ville de chaque État des États-Unis, ainsi que pour toute ville de plus de 250 000 habitants. Nous regroupons ces données issues de plusieurs sources afin de proposer les informations disponibles de la plus haute qualité. Si nous détectons des problèmes de qualité des données, nous pouvons cesser de renvoyer des données pour des divisions géographiques, des mandats ou des élus spécifiques.

Informations de vote

L'API Google Civic Information renvoie aux utilisateurs des informations civiques telles que le bureau de vote, le bureau du vote anticipé, les coordonnées du bureau électoral local et des informations sur les scrutins dans le cadre d'élections soutenues par le Voting Information Project.

Disponibilité des données

Consignes pour les développeurs

Nous demandons à tous les développeurs de respecter les consignes suivantes:

  • Respectez les Conditions d'utilisation des API.
  • En utilisant l'API, les développeurs acceptent de respecter les en-têtes de contrôle du cache, le cas échéant. En l'absence d'en-têtes de contrôle du cache, les développeurs acceptent de ne pas mettre en cache plus de 24 heures pour les bureaux de vote et les informations sur les concours, et plus de 30 jours pour les représentants et les circonscriptions.
  • Les développeurs qui utilisent l'API doivent s'efforcer de proposer la même expérience à tous les utilisateurs. Nous n'autorisons pas les retenues, les tests A/B ni les tests similaires.
  • Si vous avez besoin d'un quota supplémentaire pour répondre à votre cas d'utilisation, vous pouvez demander une augmentation par projet dans la Developer Console. Le provisionnement de quotas supplémentaires est limité et soumis à un quota maximal.

    Remarque:Le processus d'approbation prend un à deux mois.Planifiez vos demandes d'augmentation de quota en conséquence. Afin de vous préparer à l'augmentation des quotas pour les élections présidentielles de 2024,envoyez vos demandes de quotas d'ici août.

  • Les quotas supplémentaires pour l'API Civic Info ne concernent que les cas d'utilisation destinés aux utilisateurs. Les demandes d'augmentation de quota ne sont pas acceptées pour les autres cas d'utilisation.

Consignes supplémentaires concernant les données

Ces données sont particulièrement délicates à traiter. Veuillez tenir compte des points suivants.

  • Les agents électoraux modifient souvent ces données au cours des dernières semaines, voire des derniers jours précédant les élections. Il est judicieux d'avertir les utilisateurs qu'ils doivent vérifier leur présence avant de voter.
  • La plupart des flux officiels contiennent des sections de rue, ce qui signifie que les agents électoraux associent une série d'adresses aux commissariats et aux bureaux de vote. Les plages peuvent inclure ou non des électeurs inscrits à ces adresses. Par conséquent, pour les États fournissant des flux officiels via le Voting Information Project, une adresse à laquelle aucun votant n'est inscrit peut renvoyer un message de réussite.
  • Pour les États qui ne fournissent pas de flux officiel, seules les adresses où un électeur est inscrit obtiendra le résultat.
  • Parfois, nous disposons de plusieurs sources pour les mêmes informations. Nous fournissons des informations de la plus haute qualité concernant les coordonnées du bureau électoral local, ainsi que les informations sur les scrutins. Il n'existe aucun moyen d'ignorer ce comportement, si ce n'est d'éliminer les sources non officielles via le paramètre "OfficialSourcesOnly". Pour les informations sur les bureaux de vote, nous donnons toujours la priorité aux sources de données officielles aux autres sources.
  • Si nous détectons des problèmes de qualité des données, nous pouvons être amenés à ne pas fournir de données pour une circonscription spécifique tant que le problème n'est pas résolu.
  • Si nous ne disposons d'aucune donnée concernant une adresse, cela ne signifie pas nécessairement qu'il n'y a pas de vote. Les applications doivent rediriger les utilisateurs vers leur responsable électoral local pour obtenir des informations complètes.
  • Les élections expirent automatiquement après le jour des élections. Passé ce délai, aucune donnée ne sera renvoyée pour les élections.

Attribution

L'attribution à l'API Civic Information est facultative. Si un développeur choisit d'attribuer l'API à l'API Civic Information et de rediriger les utilisateurs vers des informations supplémentaires, nous demandons aux développeurs d'utiliser l'une des options de langage d'attribution suivantes et la page Web dont le lien figure ci-dessous:

  • "Fourni par l'API Civic Information"
  • "Informations de vote fournies par l'API Civic Information"
  • "Informations sur les ballons fournies par l'API Civic Information"
  • "Informations représentatives fournies par l'API Civic Information"
  • "En savoir plus"

Codes d'état

Les appels à voterInfoQuery incluent un champ status défini sur success lorsqu'une adresse est acceptée. Dans les autres cas, un code d'erreur s'affiche. Vous trouverez ci-dessous les explications les plus courantes des codes d'erreur. Notez que des informations peuvent être renvoyées même si un code d'erreur est présent.

État Explication
success L'adresse demandée est reconnue par l'API comme une adresse valide.
noStreetSegmentFound L'API ne dispose actuellement d'aucune information sur la circonscription et/ou la circonscription scolaire à laquelle cette adresse appartient. Il est possible que nous soyons encore en train de collecter/traiter de nouvelles données, ou qu'aucun électeur ne se soit inscrit pour voter à cette adresse.
addressUnparseable Le format de l'adresse demandée est incorrect ou elle ne peut pas être géocodée (en d'autres termes, l'API Google Maps ne connaît rien à son sujet).
noAddressParameter Aucune adresse n'a été indiquée.
multipleStreetSegmentsFound L'API ne trouve pas d'informations pour l'adresse spécifiée, mais elle contient des informations sur les adresses à proximité. L'utilisateur doit contacter son responsable électoral pour en savoir plus.
electionOver L'élection demandée est terminée. Les résultats de l'API pour les élections ne sont plus disponibles. Utilisez une requête electionQuery pour trouver l'ID d'une élection à venir.
electionUnknown L'ID d'élection demandé n'est pas valide. Créez une requête electionQuery pour trouver un ID valide.
internalLookupFailure Une erreur non spécifiée s'est produite lors du traitement de la requête.