Diretrizes de dados do desenvolvedor

Geografia política e representantes eleitos

A API Civic Information do Google oferece informações sobre divisões geográficas políticas e representantes eleitos de endereços dos EUA, do nível federal ao local. No momento, nossa cobertura se aproxima de 100% para os distritos estaduais, condados e congressionais, e pretendemos exceder a cobertura de 90% para os distritos legislativos estaduais. Os níveis mais baixos, como conselhos municipais e municipais, são atendidos na medida do possível e vão melhorar com o tempo.

Esperamos ter informações atualizadas sobre todos os funcionários eleitos nos níveis federal, estadual e municipal, além dos funcionários municipais da maior cidade de cada estado dos EUA, bem como de qualquer cidade com mais de 250 mil habitantes. Agregamos esses dados de várias fontes e veiculamos as informações disponíveis da mais alta qualidade. Se descobrirmos problemas de qualidade de dados, poderemos parar de retornar dados de divisões geográficas, cargos eletivos ou funcionários eleitos.

Informações sobre a votação

A API Civic Information do Google retorna informações cívicas, como local de votação, local de votação antecipada, dados de contato de autoridades locais e dados de votação aos usuários para as eleições apoiadas pelo Voting Information Project.

Disponibilidade de dados

Diretrizes para desenvolvedores

Exigimos que todos os desenvolvedores sigam estas diretrizes:

  • Obedecer aos Termos de Serviço das APIs.
  • Ao usar a API, os desenvolvedores concordam em obedecer a qualquer cabeçalho de controle de cache, se houver um. 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 do concurso e mais de 30 dias para proprietários de escritórios e distritos.
  • Os desenvolvedores que usam a API precisam fazer o máximo possível para garantir que todos os usuários tenham a mesma experiência. Não permitimos restriçõ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 para desenvolvedores. O provisionamento de cota adicional é limitado e está sujeito a um limite máximo.

    Observação:o processo de aprovação leva de um a dois meses.Planeje as solicitações de aumento de cota conforme necessário. Para se preparar para os aumentos de cota da eleição presidencial de 2024,envie solicitações de cota até agosto.

  • A cota adicional para a API Civic Info se destina apenas aos casos de uso voltados ao usuário. As solicitações de aumento de cota não são concedidas para outros casos de uso.

Diretrizes de dados adicionais

Esses dados são particularmente complicados de se trabalhar. Lembre-se do seguinte.

  • Os agentes eleitorais revisam esses dados com frequência nas últimas semanas e até mesmo nos últimos dias antes da eleição. É uma boa ideia avisar aos usuários que eles devem verificar novamente antes de votar.
  • A maioria dos feeds oficiais contém trechos de ruas, o que significa que funcionários eleitorais vinculam vários endereços a distritos e locais de votação. Os intervalos podem ou não ter eleitores registrados nesse endereço. Consequentemente, para estados que fornecem feeds oficiais por meio do Voting Information Project, um endereço no qual não há eleitores registrados pode retornar um sucesso.
  • Para os estados que não fornecem um feed oficial, somente endereços com eleitor registrado retornarão sucesso.
  • Ocasionalmente, teremos várias fontes com as mesmas informações. Disponibilizamos informações de alta qualidade disponíveis para os dados de contato e as informações de votação das autoridades eleitorais locais. Não há como substituir esse comportamento, a não ser eliminar fontes não oficiais por meio do parâmetro ProfessionalSourcesOnly. Para informações sobre locais de votação, sempre priorizamos fontes de dados oficiais em relação a outras fontes.
  • Se descobrirmos problemas de qualidade de dados, não retornaremos informações de um distrito eleitoral específico 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. As inscrições precisam direcionar os usuários aos funcionários eleitorais locais para que tenham informações completas.
  • As eleições expiram automaticamente após o dia da eleição. Depois disso, nenhum dado será retornado para a eleição.

Atribuição

A atribuição à API Civic Information é opcional. Se um desenvolvedor decidir atribuir à API Civic Information e vincular os usuários a mais informações sobre a API Civic Information, será necessário que eles usem uma das seguintes opções de idioma e da página da Web de atribuição:

  • "Tecnologia da API Civic Information"
  • "Informações sobre votação com a tecnologia da API Civic Information"
  • "Informações de balanceamento com tecnologia da API Civic Information"
  • "Informações representativas com a tecnologia da API Civic Information"
  • Saiba mais

Códigos de status

As chamadas para voterInfoQuery incluem um campo status que é 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. É possível retornar informações mesmo que haja um código de erro.

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 o distrito eleitoral e/ou o distrito eleitoral a que esse endereço pertence. Pode ser que ainda estejamos obtendo/processando novos dados ou que 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 do Google Maps não sabe nada sobre este 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 representante eleitoral para saber mais.
electionOver A eleição solicitada terminou. Os resultados da API para as eleições não estão mais disponíveis. Crie uma electionQuery para encontrar um ID para 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.