Lineamientos sobre los datos del desarrollador

Información sobre las elecciones

La API de Civic Information de Google muestra a los usuarios información cívica, como el lugar de votación, la ubicación de la votación anticipada, la información de contacto de los funcionarios electorales locales y la información de las boletas 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 obedecer cualquier encabezado de control de caché si hay alguno. En ausencia de encabezados de control de caché, los desarrolladores aceptan no almacenar en caché durante más de 24 horas la información sobre los lugares de votación y las elecciones, y durante más de 30 días la información sobre los funcionarios y los distritos.
  • 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 cuota adicional para habilitar tu caso de uso, puedes solicitar un aumento por proyecto en tu consola de desarrolladores. El aprovisionamiento de cuota adicional es limitado y está sujeto a una asignación máxima.

    Nota: El proceso de aprobación tarda entre 1 y 2 meses, por lo que recomendamos que los desarrolladores planifiquen sus solicitudes de aumento de cuota en consecuencia. Para los aumentos de cuota de las elecciones de noviembre, recomendamos enviar las solicitudes de cuota a más tardar a fines de agosto.

  • La cuota adicional para la API de Civic Information 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

Estos datos son particularmente difíciles de usar. 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 segmentos de calles, lo que significa que los funcionarios electorales vinculan un rango de direcciones a los distritos y los lugares 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 Voting Information Project, una dirección en la que no haya votantes registrados puede mostrar un resultado correcto.
  • En el caso de los estados que no proporcionan un feed oficial, solo las direcciones en las que haya un votante registrado mostrarán un resultado correcto.
  • En ocasiones, tendremos varias fuentes para la misma información. Mostramos la información de mayor calidad disponible para la información 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. Para la información sobre los lugares de votación, siempre priorizamos las fuentes de datos oficiales sobre otras fuentes.
  • Si descubrimos problemas de calidad de los datos, es posible que no mostremos 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 sus funcionarios electorales locales para obtener información completa.
  • Las elecciones vencen automáticamente después del día de las elecciones. Después de ese punto, no se mostrarán datos para la elección.

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 para obtener 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 vinculada que se muestra a continuación:

  • “Con tecnología de la API de Civic Information”
  • “Información sobre las elecciones con tecnología de la API de Civic Information”
  • “Información de las boletas con tecnología de 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 proporcionan 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 el distrito electoral o la subdivisión electoral a la que pertenece esta dirección. Es posible que aún estemos obteniendo o procesando datos nuevos, o que no haya votantes que se hayan registrado 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 las direcciones cercanas. El usuario debe comunicarse con su funcionario electoral para obtener más información.
electionOver La elección solicitada terminó. Los resultados de la API para la elección ya no están disponibles. Realiza una electionQuery para encontrar un ID para 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 durante el procesamiento de la solicitud.