Diretrizes de dados do desenvolvedor

Informações sobre a votação

A API Google Civic Information retorna informações civis, como local de votação, local de votação antecipada, informações de contato de autoridades eleitorais locais e informações de votação para eleições apoiadas pelo Projeto de Informações de Votação (em inglês).

Disponibilidade de dados

Diretrizes para desenvolvedores

Exigimos que todos os desenvolvedores sigam as diretrizes abaixo:

  • Obedeça aos Termos de Serviço das APIs.
  • Ao usar a API, os desenvolvedores concordam em obedecer a todos os cabeçalhos de controle de cache, se houver. Na ausência de cabeçalhos de controle de cache, os desenvolvedores concordam em não armazenar em cache por mais de 24 horas para locais de votação e informações sobre disputas e por mais de 30 dias para ocupantes de cargos e distritos.
  • Os desenvolvedores que usam a API precisam fazer todos os esforços para garantir que todos os usuários tenham a mesma experiência. Não permitimos retenções, testes A/B ou experimentos semelhantes.

  • Se você precisar de mais cota para ativar seu caso de uso, solicite um aumento por projeto no Developer Console. O provisionamento de cota adicional é limitado e está sujeito a uma permissão máxima.

    Observação:o processo de aprovação leva de um a dois meses.Planeje seus pedidos de aumento de cota de acordo com isso. Para se preparar para os aumentos de cota das eleições presidenciais de 2024,envie as solicitações de cota até agosto.

  • A cota extra da API Civic Info é destinada apenas a casos de uso voltados ao usuário. As solicitações de aumento de cota não são concedidas para outros casos de uso.

Outras diretrizes sobre dados

Esses dados são particularmente difíceis de trabalhar. Considere os seguintes pontos:

  • Os funcionários eleitorais revisam esses dados com frequência nas últimas semanas e até nos últimos dias antes da eleição. É uma boa ideia avisar os usuários para que verifiquem novamente antes de votar.
  • A maioria dos feeds oficiais contém trechos de ruas, o que significa que os funcionários eleitorais vinculam uma série de endereços a distritos e locais de votação. Os intervalos podem ou não ter eleitores registrados nesses endereços. Consequentemente, para estados que fornecem feeds oficiais pelo Projeto de Informações sobre Votação, um endereço em que não há eleitores registrados pode retornar um sucesso.
  • Para estados que não fornecem um feed oficial, apenas os endereços em que há um eleitor registrado vão retornar sucesso.
  • Às vezes, temos várias fontes para a mesma informação. Oferecemos informações da mais alta qualidade disponíveis sobre dados de contato de autoridades eleitorais locais e informações de votação. Não é possível substituir esse comportamento, a não ser eliminando fontes não oficiais com o parâmetro officialSourcesOnly. Para informações sobre locais de votação, sempre priorizamos fontes de dados oficiais em vez de outras fontes.
  • Se detectarmos problemas de qualidade de dados, talvez não retornemos dados de um determinado distrito eleitoral até que o problema seja resolvido.
  • Se não tivermos dados sobre um endereço, isso não significa necessariamente que não há ninguém registrado para votar lá. Os aplicativos precisam direcionar os usuários aos funcionários eleitorais locais para informações completas.
  • As eleições expiram automaticamente após o dia da votação. Nenhum dado será retornado para a eleição depois desse ponto.

Atribuição

A atribuição à API Civic Information é opcional. Se um desenvolvedor optar por atribuir à API Civic Information e vincular os usuários a mais informações sobre ela, vamos exigir que ele use uma das seguintes opções de linguagem de atribuição e a página da Web vinculada abaixo:

  • "Com tecnologia da API Civic Information"
  • "Informações de votação fornecidas pela API Civic Information"
  • "Informações sobre cédulas de votação fornecidas pela API Civic Information"
  • Saiba mais

Códigos de status

As chamadas para voterInfoQuery incluem um campo status definido como success quando um endereço é aceito. Em outros casos, um código de erro será retornado. Confira abaixo explicações comuns para códigos de erro. As informações podem ser retornadas mesmo que um código de erro esteja presente.

Status Explicação
success O endereço solicitado é reconhecido pela API como válido.
noStreetSegmentFound No momento, a API não tem informações sobre a seção eleitoral e/ou o distrito a que esse endereço pertence. Talvez ainda estejamos buscando/processando novos dados ou não haja eleitores registrados para votar nesse endereço.
addressUnparseable O endereço solicitado não está formatado corretamente ou não pode ser geocodificado (ou seja, a API Google Maps não sabe nada sobre esse endereço).
noAddressParameter Nenhum endereço foi fornecido.
multipleStreetSegmentsFound A API não consegue encontrar informações para o endereço especificado, mas tem informações sobre endereços próximos. O usuário precisa entrar em contato com o órgão eleitoral para mais informações.
electionOver A eleição solicitada já terminou. Os resultados da API para a eleição não estão mais disponíveis. Faça uma electionQuery para encontrar um ID de uma próxima eleição.
electionUnknown O ID da eleição solicitado é inválido. Faça uma electionQuery para encontrar um ID válido.
internalLookupFailure Ocorreu um erro não especificado ao processar a solicitação.