Lineamientos sobre los datos del desarrollador

Geografía política y representantes electos

La API de información cívica de Google ofrece información sobre divisiones geográficas políticas y representantes electos para direcciones de EE.UU., desde el nivel federal hasta el local. En la actualidad, tenemos una cobertura que se acerca al 100% para los distritos estatales, municipales y del Congreso, y pretendemos exceder el 90% de cobertura para los distritos legislativos estatales. Los niveles inferiores, como los ayuntamientos de ciudades y condados, se basan en el mejor esfuerzo y mejorarán con el tiempo.

Esperamos tener información actualizada sobre todos los funcionarios electos a nivel federal, estatal y municipal, y sobre los funcionarios municipales de las ciudades más grandes de cada estado de EE.UU., así como de cualquier ciudad con más de 250,000 habitantes. Combinamos estos datos de varias fuentes y publicamos la información disponible de la más alta calidad. Si detectamos problemas en la calidad de los datos, es posible que detengamos la devolución de datos para determinadas divisiones geográficas, cargos electos o funcionarios electos.

Información sobre las votaciones

La API de información cívica de Google muestra información cívica, como centros de votación, ubicación de votación anticipada, información de contacto del funcionario electoral local y datos sobre las boletas para las elecciones compatibles con el Proyecto de información de votación.

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.
  • Al usar la API, los desarrolladores aceptan obedecer los encabezados de control de caché si los hay. A falta de encabezados de control de caché, los desarrolladores acuerdan no almacenar en caché durante más de 24 horas para los lugares de votación e información sobre concursos, y más de 30 días para los funcionarios y 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 Play 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 según corresponda. Para prepararte para los aumentos de cuota de las elecciones presidenciales de 2024,envía solicitudes de cuota antes de agosto.

  • La cuota adicional para la API de Civic Info solo está diseñada para admitir casos de uso para el usuario. Las solicitudes de aumento de cuota no se otorgan para otros casos de uso.

Lineamientos de datos adicionales

Trabajar con estos datos es particularmente complicado. Ten en cuenta los siguientes puntos.

  • Los funcionarios electorales revisan estos datos con frecuencia durante las últimas semanas e incluso los últimos días previos a las elecciones. Es una buena idea advertir a los usuarios que deben volver a verificar antes de votar.
  • La mayoría de los feeds oficiales incluyen tramos de calle, lo que significa que los funcionarios electorales vinculan un rango de direcciones a los distritos y los centros de votación. Los rangos pueden o no tener votantes registrados en esas direcciones. En consecuencia, en el caso de los estados que proporcionen feeds oficiales a través del Proyecto de información de votación, una dirección en la que no haya votantes registrados puede devolver un resultado exitoso.
  • En el caso de los estados que no proporcionen un feed oficial, solo se mostrarán las direcciones en las que haya un votante registrado.
  • De vez en cuando, tendremos varias fuentes para la misma información. Proporcionamos la información de más alta calidad disponible para la información de contacto y sobre las boletas de los funcionarios electorales locales. No hay forma de anular este comportamiento, salvo eliminar fuentes no oficiales a través del parámetro oficialSourcesOnly. Para la información sobre centros de votación, siempre priorizamos las fuentes de datos oficiales sobre otras.
  • Si descubrimos problemas en la calidad de los datos, es posible que no mostremos datos de un distrito electoral en particular hasta que se resuelva el problema.
  • Que no tengamos datos de una dirección no significa necesariamente que no haya nadie registrado para votar en ella. 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. No se devolverán datos para la elección después de ese momento.

Atribución

La atribución a la API de Civic Information es opcional. Si un desarrollador opta por atribuirse a la API de Civic Information y vincular a los usuarios con la información de la API, les solicitamos a los desarrolladores que utilicen una de las siguientes opciones de lenguaje de atribución y la página web vinculada a continuación:

  • “Con la tecnología de la API de Civic Information”
  • “Información de votación con la tecnología de la API de Civic Information”
  • “Información de las balones con la tecnología de la API de Civic Information”
  • “Información representativa con la 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 de los códigos de error. Ten en cuenta que se puede mostrar 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 distrito 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 (p.ej., la Google Maps API 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 ya finalizó. Ya no están disponibles los resultados de la API para las elecciones. Haz una electionQuery a fin de encontrar un ID para una próxima elección.
electionUnknown El ID electoral 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.