Lineamientos sobre los datos del desarrollador

Información sobre la votación

La API de Google Civic Information devuelve información cívica, como el lugar de votación, la ubicación para votar anticipadamente, la información de contacto de los funcionarios electorales locales y la información de la boleta electoral a los usuarios para las elecciones compatibles con el Voting Information Project.

Disponibilidad de los datos

Lineamientos para desarrolladores

Exigimos que todos los desarrolladores cumplan con los siguientes lineamientos:

  • Cumple con las condiciones del servicio de las APIs.
  • Cuando usan la API, los desarrolladores aceptan cumplir con los encabezados de control de caché, si los hay. En ausencia de encabezados de cache-control, los desarrolladores aceptan no almacenar en caché durante más de 24 horas las ubicaciones de votación y la información de las elecciones, y durante más de 30 días los cargos públicos y los distritos.
  • Los desarrolladores que usen 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 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 una asignación máxima.

    Nota: El proceso de aprobación tarda de 1 a 2 meses.Planifica tus solicitudes de aumento de cuota en consecuencia. 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 de datos adicionales

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

  • Los funcionarios electorales revisan estos datos con frecuencia en las últimas semanas e incluso 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 distritos electorales y centros de votación. Es posible que en los rangos haya 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 haya votantes registrados puede devolver un éxito.
  • En el caso de los estados que no proporcionan un feed oficial, solo se devolverá un resultado exitoso para las direcciones en las que haya un votante registrado.
  • En ocasiones, tendremos varias fuentes para la misma información. Proporcionamos la información de mayor calidad disponible sobre los datos de contacto de los funcionarios electorales locales y la información de las boletas. No hay forma de anular este comportamiento, excepto eliminar las fuentes no oficiales a través del parámetro officialSourcesOnly. En el caso de la información sobre los centros de votación, siempre priorizamos las fuentes de datos oficiales por sobre otras fuentes.
  • Si detectamos problemas de calidad de los datos, es posible que no devolvamos datos para 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 los funcionarios electorales locales para obtener información completa.
  • Las elecciones vencen automáticamente después de la jornada electoral. Después de ese punto, no se devolverán datos sobre la elección.

Atribución

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

  • "Con tecnología de la API de Civic Information"
  • "Información sobre votaciones proporcionada por la API de Civic Information"
  • "Información de la boleta electoral proporcionada 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 indican las explicaciones comunes para 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 o recinto electoral pertenece esta dirección. Es posible que aún estemos obteniendo 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 sobre la dirección especificada, pero sí tiene información sobre direcciones cercanas. El usuario debe comunicarse con el funcionario electoral para obtener más información.
electionOver La elección solicitada finalizó. Los resultados de la API para 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 al procesar la solicitud.