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

Informations sur le vote

L'API Google Civic Information renvoie aux utilisateurs des informations civiques telles que le bureau de vote, le lieu de vote anticipé, les coordonnées des responsables locaux des élections et des informations sur les bulletins de vote pour les élections prises en charge par le Voting Information Project.

Disponibilité des données

Consignes destinées aux 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 cache-control, les développeurs s'engagent à ne pas mettre en cache les informations sur les lieux de vote et les élections pendant plus de 24 heures, et les informations sur les titulaires de fonctions et les circonscriptions pendant plus de 30 jours.
  • Les développeurs qui utilisent l'API doivent tout mettre en œuvre pour que tous les utilisateurs bénéficient de la même expérience. Nous n'autorisons pas les retenues, les tests A/B ni les expériences similaires.

  • Si vous avez besoin d'un quota supplémentaire pour activer votre cas d'utilisation, vous pouvez demander une augmentation par projet dans la console de développeur. L'attribution de quota supplémentaire est limitée et soumise à une allocation maximale.

    Remarque : Le processus d'approbation prend un à deux mois.Planifiez vos demandes d'augmentation de quota en conséquence. Pour vous préparer aux augmentations de quota liées aux élections présidentielles de 2024,envoyez vos demandes de quota d'ici le mois d'août.

  • Le quota supplémentaire pour l'API Civic Info est uniquement destiné à prendre en charge 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 pour les données

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

  • Les responsables des élections révisent souvent ces données au cours des dernières semaines, voire des derniers jours avant les élections. Il est conseillé d'avertir les utilisateurs qu'ils doivent revenir avant de voter.
  • La plupart des flux officiels contiennent des segments de rue, ce qui signifie que les responsables des élections associent une plage d'adresses à des circonscriptions et à des bureaux de vote. Il se peut qu'aucun électeur ne soit inscrit à ces adresses. Par conséquent, pour les États qui fournissent des flux officiels via le Voting Information Project, une adresse à laquelle aucun électeur n'est inscrit peut renvoyer un résultat positif.
  • Pour les États qui ne fournissent pas de flux officiel, seules les adresses où un électeur est inscrit renverront un résultat positif.
  • Il peut arriver que nous disposions de plusieurs sources pour une même information. Nous fournissons les informations de la plus haute qualité disponibles sur les coordonnées des responsables des élections locales et sur les bulletins de vote. Il n'existe aucun moyen de remplacer ce comportement, si ce n'est en éliminant les sources non officielles à l'aide du paramètre officialSourcesOnly. Pour les informations sur les bureaux de vote, nous privilégions toujours les sources de données officielles par rapport aux autres sources.
  • Si nous détectons des problèmes de qualité des données, il est possible que nous ne renvoyions aucune donnée pour une circonscription électorale spécifique tant que le problème n'est pas résolu.
  • Si nous ne disposons pas de données sur une adresse, cela ne signifie pas nécessairement qu'aucune personne n'y est inscrite sur les listes électorales. Les applications doivent rediriger les utilisateurs vers les responsables locaux des élections pour obtenir des informations complètes.
  • Les élections expirent automatiquement après le jour du scrutin. Après cette date, aucune donnée ne sera renvoyée pour l'élection.

Attribution

L'attribution à l'API Civic Information est facultative. Si un développeur choisit d'attribuer l'API Civic Information et de rediriger les utilisateurs vers plus d'informations sur cette API, nous lui demandons d'utiliser l'une des options de texte d'attribution et la page Web ci-dessous :

  • "Optimisé par l'API Civic Information"
  • "Informations sur le vote fournies par l'API Civic Information"
  • "Informations sur le bulletin de vote 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 est renvoyé. Vous trouverez ci-dessous des explications courantes pour les 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 électorale et/ou le district auxquels appartient cette adresse. Il est possible que nous soyons encore en train de collecter ou de traiter de nouvelles données, ou qu'aucun électeur ne soit inscrit à cette adresse.
addressUnparseable L'adresse demandée n'est pas au bon format ou ne peut pas être géocodée (c'est-à-dire que l'API Google Maps ne connaît pas cette adresse).
noAddressParameter Aucune adresse n'a été fournie.
multipleStreetSegmentsFound L'API ne trouve pas d'informations pour l'adresse spécifiée, mais elle en possède pour les adresses à proximité. L'utilisateur doit contacter son responsable des élections pour en savoir plus.
electionOver L'élection demandée est terminée. Les résultats de l'élection ne sont plus disponibles dans l'API. Effectuez une electionQuery pour trouver l'ID d'une élection à venir.
electionUnknown L'ID d'élection demandé n'est pas valide. Effectuez une electionQuery pour trouver un ID valide.
internalLookupFailure Une erreur non spécifiée s'est produite lors du traitement de la demande.