Diretrizes de dados do desenvolvedor

Informações sobre a votação

A API Google Civic Information retorna informações cívicas, como local de votação, local de votação antecipada, informações de contato oficiais das eleições locais e informações da cédula para usuários de eleições com suporte do Voting Information Project.

Disponibilidade de dados

Diretrizes para desenvolvedores

Todos os desenvolvedores precisam seguir estas diretrizes:

  • Observe os 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 de concurso 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 console do desenvolvedor. O provisionamento de cota adicional é limitado e está sujeito a uma permissão máxima.

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

  • A cota extra da API Civic Info é destinada apenas a casos de uso do 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é mesmo nos últimos dias antes da eleição. É recomendável avisar os usuários que eles precisam conferir novamente antes de votar.
  • A maioria dos feeds oficiais contém segmentos de ruas, o que significa que os funcionários eleitorais vinculam uma série de endereços a seções eleitorais 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 de 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. Fornecemos as informações de contato e de votação oficiais das eleições locais com a melhor qualidade disponível. Não é possível modificar esse comportamento, a não ser eliminando as fontes não oficiais usando o parâmetro officialSourcesOnly. Para informações sobre locais de votação, sempre priorizamos fontes de dados oficiais em vez de outras fontes.
  • Se descobrirmos 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 nele. Os apps precisam direcionar os usuários aos funcionários eleitorais locais para informações completas.
  • As eleições expiram automaticamente após o dia da eleição. Nenhum dado será retornado para a eleição após esse 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 a API Civic Information, ele precisará usar uma das seguintes opções de idioma de atribuição e a página da Web vinculada abaixo:

  • "Com tecnologia da API Civic Information"
  • "Informações de votação com a API Civic Information"
  • "Informações sobre a cédula usando a 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 um endereço válido.
noStreetSegmentFound No momento, a API não tem informações sobre a seção eleitoral e/ou o distrito a que o endereço pertence. Talvez ainda estejamos coletando/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 encontra informações sobre o endereço especificado, mas tem informações sobre endereços próximos. O usuário precisa entrar em contato com o oficial eleitoral para mais informações.
electionOver A eleição solicitada acabou. Os resultados da API para a eleição não estão mais disponíveis. Crie uma electionQuery para encontrar um ID de uma eleição futura.
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.