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

Informations sur le vote

L'API Google Civic Information fournit aux utilisateurs des informations civiques telles que le bureau de vote, le lieu de vote anticipé, les coordonnées des autorités électorales locales et les informations sur les bulletins de vote pour les élections prises en charge par le projet Voting Information.

Disponibilité des données

Consignes destinées aux développeurs

Tous les développeurs doivent respecter les consignes suivantes:

  • Respectez les conditions d'utilisation des API.
  • En utilisant l'API, les développeurs acceptent de respecter les éventuels en-têtes de contrôle de la mise en cache. En l'absence d'en-têtes de contrôle de la mise en cache, 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, ni les informations sur les élus 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 holdbacks, 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 du développeur. Le provisionnement de quotas supplémentaires est limité et soumis à une tolérance maximale.

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

  • Le quota supplémentaire pour l'API Civic Info n'est destiné qu'aux cas d'utilisation vis-à-vis des utilisateurs. Les demandes d'augmentation de quota ne sont pas accordées pour d'autres cas d'utilisation.

Consignes supplémentaires pour les données

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

  • Les autorités électorales révisent souvent ces données au cours des dernières semaines, voire des derniers jours avant les élections. Il est recommandé 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 autorités électorales associent une plage d'adresses à des bureaux de vote et à des bureaux de vote. Il est possible 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 où aucun électeur n'est enregistré peut renvoyer un résultat positif.
  • Pour les États qui ne fournissent pas de flux officiel, seules les adresses pour lesquelles un électeur est enregistré renvoient un résultat positif.
  • Il arrive que nous disposions de plusieurs sources pour une même information. Nous fournissons les informations les plus fiables possible sur les coordonnées des autorités électorales locales et les bulletins de vote. Il n'existe aucun moyen de remplacer ce comportement, sauf à supprimer 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 par rapport aux autres sources.
  • Si nous détectons des problèmes de qualité des données, nous pouvons ne renvoyer aucune donnée pour un district électoral donné 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'aucun électeur n'y est inscrit. Les applications doivent rediriger les utilisateurs vers les autorités électorales locales pour obtenir des informations complètes.
  • Les élections expirent automatiquement après le jour du scrutin. Aucune donnée ne sera renvoyée pour l'élection après cette date.

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 des informations supplémentaires sur cette API, nous lui demandons d'utiliser l'une des options de langue d'attribution suivantes et la page Web associée ci-dessous:

  • "Propulsé par l'API Civic Information"
  • "Informations sur les élections fournies par l'API Civic Information"
  • "Informations sur les bulletins 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 sur 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 le bureau de vote et/ou le district auquel cette adresse appartient. Il est possible que nous soyons encore en train de collecter/traiter de nouvelles données ou qu'aucun électeur ne soit enregistré pour voter à cette adresse.
addressUnparseable L'adresse demandée n'est pas correctement formatée ou ne peut pas être géocodée (c'est-à-dire que l'API Google Maps ne connaît rien de cette adresse).
noAddressParameter Aucune adresse n'a été fournie.
multipleStreetSegmentsFound L'API ne trouve pas d'informations sur l'adresse spécifiée, mais elle dispose d'informations sur les adresses à proximité. L'utilisateur doit contacter son autorité électorale pour en savoir plus.
electionOver L'élection demandée est terminée. Les résultats de l'API pour l'élection ne sont plus disponibles. 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 requête.