Lineamientos sobre los datos del desarrollador

Información sobre la votación

La API de Google Civic Information muestra información cívica, como el lugar de votación, la ubicación de votación anticipada, la información de contacto oficial de las elecciones locales y la información de los votos a los usuarios para las elecciones que admite el Voting Information Project.

Disponibilidad de los datos

Lineamientos para desarrolladores

Todos los desarrolladores deben cumplir con los siguientes lineamientos:

  • Cumplir con las Condiciones del Servicio de las APIs
  • Cuando usan la API, los desarrolladores aceptan obedecer cualquier encabezado de control de caché, si hay uno. Si no hay encabezados de control de caché, los desarrolladores aceptan no almacenar en caché durante más de 24 horas la información de los concursos y las ubicaciones de votación, y más de 30 días para los distritos y los titulares de cargos.
  • Los desarrolladores que usan la API deben hacer todo lo posible para garantizar que todos los usuarios tengan la misma experiencia. No permitimos retenciones, pruebas A/B ni experimentos similares.

  • Si necesitas una cuota adicional para habilitar tu caso de uso, puedes solicitar un aumento por proyecto en Developer Console. El aprovisionamiento de cuota adicional es limitado y está sujeto a un límite máximo.

    Nota: El proceso de aprobación demora entre 1 y 2 meses.Planifica tus solicitudes de aumento de cuota según corresponda. Para prepararte para los aumentos de cuota de las elecciones presidenciales de 2024,envía las solicitudes de cuota antes de agosto.

  • La cuota adicional para la API de Civic Info solo está destinada a admitir casos de uso orientados al usuario. No se otorgan solicitudes de aumento de cuota para otros casos de uso.

Lineamientos adicionales de los datos

Es difícil trabajar con estos datos. Ten en cuenta los siguientes puntos.

  • Los funcionarios electorales revisan estos datos con frecuencia en las últimas semanas y hasta en los últimos días antes de las elecciones. Es una buena idea advertir a los usuarios que deben volver a consultar antes de votar.
  • La mayoría de los feeds oficiales contienen tramos de calles, lo que significa que los funcionarios electorales vinculan un rango de direcciones a los distritos y las ubicaciones de votación. Es posible que los rangos tengan o no votantes registrados en esas direcciones. En consecuencia, para los estados que proporcionan feeds oficiales a través del Proyecto de información electoral, una dirección en la que no hay votantes registrados puede mostrar un estado de éxito.
  • En el caso de los estados que no proporcionan un feed oficial, solo se mostrarán como correctas las direcciones en las que haya un votante registrado.
  • En ocasiones, tendremos varias fuentes para la misma información. Publicamos la información de la más alta calidad disponible sobre la información de contacto oficial y las boletas de las elecciones locales. No hay forma de anular este comportamiento, salvo eliminar las fuentes no oficiales a través del parámetro officialSourcesOnly. En el caso de la información sobre los lugares de votación, siempre priorizamos las fuentes de datos oficiales sobre otras fuentes.
  • Si detectamos problemas de calidad de los datos, es posible que no mostremos datos de un distrito electoral en particular hasta que se resuelva el problema.
  • Si no tenemos datos sobre una dirección, no significa necesariamente que no haya nadie registrado para votar allí. Las aplicaciones deben dirigir a los usuarios a sus autoridades electorales locales para obtener información completa.
  • Las elecciones vencen automáticamente después de la jornada electoral. No se mostrarán datos de la elección después de ese momento.

Atribución

La atribución a la API de Civic Information es opcional. Si un desarrollador elige atribuir a la API de Civic Information y vincular a los usuarios a más información sobre la API de Civic Information, exigimos que los desarrolladores usen una de las siguientes opciones de lenguaje de atribución y la página web que se indica a continuación:

  • "Con la tecnología de la API de Civic Information"
  • "Información sobre el voto con la API de Civic Information"
  • "Información de la boleta potenciada por la API de Civic Information"
  • “Más información”

Códigos de estado

Las llamadas a voterInfoQuery incluyen un campo status que se establece en success cuando se acepta una dirección. En otros casos, se mostrará un código de error. A continuación, se incluyen explicaciones comunes de los códigos de error. Ten en cuenta que es posible que se muestre información incluso si hay un código de error.

Estado Explicación
success La API reconoce la dirección solicitada como una dirección válida.
noStreetSegmentFound Actualmente, la API no tiene información sobre a qué distrito electoral o circunscripción pertenece esta dirección. Es posible que aún estemos recopilando o procesando datos nuevos, o que no haya votantes registrados para votar en esta dirección.
addressUnparseable La dirección solicitada no tiene el formato correcto o no se puede geocodificar (es decir, la API de Google Maps no sabe nada sobre esta dirección).
noAddressParameter No se proporcionó ninguna dirección.
multipleStreetSegmentsFound La API no puede encontrar información para la dirección especificada, pero tiene información sobre direcciones cercanas. El usuario debe comunicarse con su funcionario electoral para obtener más información.
electionOver La elección solicitada finalizó. Los resultados de la API de las elecciones ya no están disponibles. Realiza una electionQuery para encontrar el ID de una próxima elección.
electionUnknown El ID de elección solicitado no es válido. Realiza una electionQuery para encontrar un ID válido.
internalLookupFailure Se produjo un error no especificado cuando se procesaba la solicitud.