Procura informações relevantes para um eleitor com base no endereço registrado dele. Faça o teste agora.
- Locais de votação (incluindo locais de votação antecipada) para um determinado endereço residencial
- Informações sobre o concurso e o candidato
- Informações sobre os oficiais das eleições
Solicitação
Solicitação HTTP
GET https://www.googleapis.com/civicinfo/v2/voterinfo
Parâmetros
Nome do parâmetro | Valor | Descrição |
---|---|---|
Parâmetros de consulta obrigatórios | ||
address |
string |
O endereço registrado do eleitor a ser procurado. |
Parâmetros de consulta opcionais | ||
electionId |
long |
O código exclusivo da eleição a ser pesquisada. Acesse uma lista de IDs eleitorais em https://www.googleapis.com/civicinfo/{version}/elections. Se nenhum documento de identificação eleitoral for especificado na consulta e houver mais de uma eleição com dados do eleitor em questão, as outras eleições serão fornecidas no campo de resposta Se não houver uma eleição ao vivo para o endereço do eleitor fornecido, a resposta só retornará os dados se o documento de identificação estiver especificado. Recomendamos, nesse caso, que qualquer ferramenta emita uma segunda consulta com o ID da eleição especificado para garantir que as informações corretas sobre o local de votação, o concurso e os funcionários eleitorais (quando aplicável) sejam fornecidas ao usuário. |
officialOnly |
boolean |
Se ela for definida como verdadeira, apenas os dados de fontes estaduais oficiais serão retornados.
Padrão: false .
|
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{ "kind": "civicinfo#voterInfoResponse", "election": elections Resource, "otherElections": [ elections Resource ], "normalizedInput": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "pollingLocations": [ { "address": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "notes": string, "pollingHours": string, "name": string, "voterServices": string, "startDate": string, "endDate": string, "latitude": double, "longitude": double, "sources": [ { "name": string, "official": boolean } ] } ], "earlyVoteSites": [ { "address": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "notes": string, "pollingHours": string, "name": string, "voterServices": string, "startDate": string, "endDate": string, "latitude": double, "longitude": double, "sources": [ { "name": string, "official": boolean } ] } ], "dropOffLocations": [ { "address": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "notes": string, "pollingHours": string, "name": string, "voterServices": string, "startDate": string, "endDate": string, "latitude": double, "longitude": double, "sources": [ { "name": string, "official": boolean } ] } ], "contests": [ { "type": string, "primaryParty": string, "electorateSpecifications": string, "special": string, "ballotTitle": string, "office": string, "level": [ string ], "roles": [ string ], "district": { "name": string, "scope": string, "id": string }, "numberElected": long, "numberVotingFor": long, "ballotPlacement": long, "candidates": [ { "name": string, "party": string, "candidateUrl": string, "phone": string, "photoUrl": string, "email": string, "orderOnBallot": long, "channels": [ { "type": string, "id": string } ] } ], "referendumTitle": string, "referendumSubtitle": string, "referendumUrl": string, "referendumBrief": string, "referendumText": string, "referendumProStatement": string, "referendumConStatement": string, "referendumPassageThreshold": string, "referendumEffectOfAbstain": string, "referendumBallotResponses": [ string ], "sources": [ { "name": string, "official": boolean } ] } ], "state": [ { "name": string, "electionAdministrationBody": { "name": string, "electionInfoUrl": string, "electionRegistrationUrl": string, "electionRegistrationConfirmationUrl": string, "electionNoticeText": string, "electionNoticeUrl": string, "absenteeVotingInfoUrl": string, "votingLocationFinderUrl": string, "ballotInfoUrl": string, "electionRulesUrl": string, "voter_services": [ string ], "hoursOfOperation": string, "correspondenceAddress": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "physicalAddress": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "electionOfficials": [ { "name": string, "title": string, "officePhoneNumber": string, "faxNumber": string, "emailAddress": string } ] }, "local_jurisdiction": (AdministrationRegion), "sources": [ { "name": string, "official": boolean } ] } ], "mailOnly": boolean }
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
kind |
string |
Identifica o tipo de recurso. Valor: a string fixa "civicinfo#voterInfoResponse" . |
|
election |
nested object |
A eleição que foi consultada. | |
otherElections[] |
list |
Quando há várias eleições para um endereço de eleitor, o campo otherElections é preenchido na resposta da API e há duas possibilidades:1) Se essas eleições ocorrerem em dias diferentes, a API vai retornar as informações da primeira/mais antiga eleição. Se a eleição mais próxima não for a pretendida, especifique o código dela em uma segunda solicitação de API usando o campo electionId .2) Caso essas eleições ocorram no mesmo dia, a API não vai retornar informações sobre locais de votação, disputas ou funcionários eleitorais para garantir que outra consulta seja feita. Em apps voltados ao usuário, recomendamos exibir essas eleições para o usuário para fins de desambiguação. Uma segunda solicitação de API usando o campo electionId precisa ser feita para a eleição relevante para o usuário.
|
|
normalizedInput |
nested object |
A versão normalizada do endereço solicitado | |
normalizedInput.locationName |
string |
Nome do local. | |
normalizedInput.line1 |
string |
O nome da rua e o número desse endereço. | |
normalizedInput.line2 |
string |
A segunda linha, o endereço, se necessário. | |
normalizedInput.line3 |
string |
A terceira linha do endereço, se necessário. | |
normalizedInput.city |
string |
A cidade do endereço. | |
normalizedInput.state |
string |
A abreviação de estado com duas letras dos EUA do endereço. | |
normalizedInput.zip |
string |
O CEP do endereço nos EUA. | |
mailOnly |
boolean |
Especifica se os eleitores do distrito eleitoral votam apenas enviando suas cédulas pelo correio, com a possível opção de desistir de suas cédulas. |
Locais de votação, locais de votação inicial e de desembarque
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
pollingLocations[] |
list |
Locais em que o eleitor pode votar no dia da eleição. | |
pollingLocations[].address |
nested object |
O endereço do local. | |
pollingLocations[].address.locationName |
string |
Nome do local. | |
pollingLocations[].address.line1 |
string |
O nome da rua e o número desse endereço. | |
pollingLocations[].address.line2 |
string |
A segunda linha, o endereço, se necessário. | |
pollingLocations[].address.line3 |
string |
A terceira linha do endereço, se necessário. | |
pollingLocations[].address.city |
string |
A cidade do endereço. | |
pollingLocations[].address.state |
string |
A abreviação de estado com duas letras dos EUA do endereço. | |
pollingLocations[].address.zip |
string |
O CEP do endereço nos EUA. | |
pollingLocations[].notes |
string |
Observações sobre esse local (por exemplo, rampa de acessibilidade ou entrada para usar). | |
pollingLocations[].pollingHours |
string |
Uma descrição de quando o local está aberto. | |
pollingLocations[].name |
string |
O nome do local de votação antecipada ou local de desembarque. Esse campo não é preenchido para locais de votação. | |
pollingLocations[].voterServices |
string |
Os serviços prestados por esse site de votação antecipada ou local de desembarque. Esse campo não é preenchido para locais de votação. | |
pollingLocations[].startDate |
string |
A primeira data em que esse local de voto antecipado ou local de desembarque pode ser usado. Esse campo não é preenchido para locais de votação. | |
pollingLocations[].endDate |
string |
A última data em que esse local de votação antecipada ou local de desembarque pode ser usado. Esse campo não é preenchido para locais de votação. | |
pollingLocations[].latitude |
string |
Latitude do local, em graus ao norte da linha do Equador. Esse campo pode não estar disponível em alguns locais. | |
pollingLocations[].longitude |
string |
Longitude do local, em graus a leste do Meridiano de Greenwich. Esse campo pode não estar disponível em alguns locais. | |
pollingLocations[].sources[] |
list |
Uma lista de origens deste local. Se várias fontes estiverem listadas, os dados foram agregados delas. | |
pollingLocations[].sources[].name |
string |
Nome da fonte de dados. | |
pollingLocations[].sources[].official |
boolean |
Se esses dados vêm de uma fonte governamental oficial. | |
earlyVoteSites[] |
list |
Locais em que o eleitor pode votar antecipadamente, antes do dia da eleição. | |
earlyVoteSites[].address |
nested object |
O endereço do local. | |
earlyVoteSites[].address.locationName |
string |
Nome do local. | |
earlyVoteSites[].address.line1 |
string |
O nome da rua e o número desse endereço. | |
earlyVoteSites[].address.line2 |
string |
A segunda linha, o endereço, se necessário. | |
earlyVoteSites[].address.line3 |
string |
A terceira linha do endereço, se necessário. | |
earlyVoteSites[].address.city |
string |
A cidade do endereço. | |
earlyVoteSites[].address.state |
string |
A abreviação de estado com duas letras dos EUA do endereço. | |
earlyVoteSites[].address.zip |
string |
O CEP do endereço nos EUA. | |
earlyVoteSites[].notes |
string |
Observações sobre esse local (por exemplo, rampa de acessibilidade ou entrada para usar). | |
earlyVoteSites[].pollingHours |
string |
Uma descrição de quando o local está aberto. | |
earlyVoteSites[].name |
string |
O nome do local de votação antecipada ou local de desembarque. Esse campo não é preenchido para locais de votação. | |
earlyVoteSites[].voterServices |
string |
Os serviços prestados por esse site de votação antecipada ou local de desembarque. Esse campo não é preenchido para locais de votação. | |
earlyVoteSites[].startDate |
string |
A primeira data em que esse local de voto antecipado ou local de desembarque pode ser usado. Esse campo não é preenchido para locais de votação. | |
earlyVoteSites[].endDate |
string |
A última data em que esse local de votação antecipada ou local de desembarque pode ser usado. Esse campo não é preenchido para locais de votação. | |
earlyVoteSites[].latitude |
string |
Latitude do local, em graus ao norte da linha do Equador. Esse campo pode não estar disponível em alguns locais. | |
earlyVoteSites[].longitude |
string |
Longitude do local, em graus a leste do Meridiano de Greenwich. Esse campo pode não estar disponível em alguns locais. | |
earlyVoteSites[].sources[] |
list |
Uma lista de origens deste local. Se várias fontes estiverem listadas, os dados foram agregados delas. | |
earlyVoteSites[].sources[].name |
string |
Nome da fonte de dados. | |
earlyVoteSites[].sources[].official |
boolean |
Se esses dados vêm de uma fonte governamental oficial. | |
dropOffLocations[] |
list |
Locais em que um eleitor se qualifica para entregar uma cédula preenchida. O eleitor precisa ter recebido e concluído uma cédula antes de chegar ao local. O local pode não ter cédulas disponíveis. Esses locais podem estar abertos no dia da eleição ou antes dele, conforme indicado no campo de horários de votação. | |
dropOffLocations[].address |
nested object |
O endereço do local. | |
dropOffLocations[].address.locationName |
string |
Nome do local. | |
dropOffLocations[].address.line1 |
string |
O nome da rua e o número desse endereço. | |
dropOffLocations[].address.line2 |
string |
A segunda linha, o endereço, se necessário. | |
dropOffLocations[].address.line3 |
string |
A terceira linha do endereço, se necessário. | |
dropOffLocations[].address.city |
string |
A cidade do endereço. | |
dropOffLocations[].address.state |
string |
A abreviação de estado com duas letras dos EUA do endereço. | |
dropOffLocations[].address.zip |
string |
O CEP do endereço nos EUA. | |
dropOffLocations[].notes |
string |
Observações sobre esse local (por exemplo, rampa de acessibilidade ou entrada para usar). | |
dropOffLocations[].pollingHours |
string |
Uma descrição de quando o local está aberto. | |
dropOffLocations[].name |
string |
O nome do local de votação antecipada ou local de desembarque. Esse campo não é preenchido para locais de votação. | |
dropOffLocations[].voterServices |
string |
Os serviços prestados por esse site de votação antecipada ou local de desembarque. Esse campo não é preenchido para locais de votação. | |
dropOffLocations[].startDate |
string |
A primeira data em que esse local de voto antecipado ou local de desembarque pode ser usado. Esse campo não é preenchido para locais de votação. | |
dropOffLocations[].endDate |
string |
A última data em que esse local de votação antecipada ou local de desembarque pode ser usado. Esse campo não é preenchido para locais de votação. | |
dropOffLocations[].latitude |
string |
Latitude do local, em graus ao norte da linha do Equador. Esse campo pode não estar disponível em alguns locais. | |
dropOffLocations[].longitude |
string |
Longitude do local, em graus a leste do Meridiano de Greenwich. Esse campo pode não estar disponível em alguns locais. | |
dropOffLocations[].sources[] |
list |
Uma lista de origens deste local. Se várias fontes estiverem listadas, os dados foram agregados delas. | |
dropOffLocations[].sources[].name |
string |
Nome da fonte de dados. | |
dropOffLocations[].sources[].official |
boolean |
Se esses dados vêm de uma fonte governamental oficial. |
Concursos
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
contests[] |
list |
Concursos que aparecerão na cédula do eleitor. | |
contests[].type |
string |
O tipo de concurso. Normalmente, será "Geral", "Principal" ou "Segundo turno". para concursos com candidatos. Em referendos, será "Referendo". | |
contests[].primaryParty |
string |
Se for uma eleição partidária, o nome do partido a que se refere. | |
contests[].electorateSpecifications |
string |
Uma descrição de quaisquer requisitos adicionais de qualificação para votar neste concurso. | |
contests[].special |
string |
"Sim" ou "Não" dependendo de o concurso ser realizado fora do ciclo eleitoral normal. | |
contests[].ballotTitle |
string |
O título oficial na cédula deste concurso, quando disponível. | |
contests[].office |
string |
O nome do escritório deste concurso. | |
contests[].level[] |
list |
Os níveis de governo usados para o concurso. Pode haver mais de um nos casos em que uma jurisdição atue efetivamente em dois níveis de governo diferentes; Por exemplo, o prefeito do Distrito de Colúmbia atua no nível locality , mas também de forma eficaz em ambos administrativeArea2 eadministrativeArea1 .Os valores válidos incluem:
|
|
contests[].roles[] |
list |
As funções que o escritório deste concurso cumpre. As funções não são exaustivas ou especificam exatamente todo o conjunto de responsabilidades de um determinado escritório. Elas são categorias aproximadas úteis para a seleção ou classificação de uma lista de escritórios. Valores válidos incluem:
|
|
contests[].district |
nested object |
Informações sobre o distrito eleitoral em que o concurso está localizado. | |
contests[].district.name |
string |
É o nome do distrito. | |
contests[].district.scope |
string |
O escopo geográfico do distrito. Se não for especificada, a região geográfica do distrito é desconhecida. Uma destas opções: nacional, estadual, congressional, stateUpper, stateLower, condado, judicial, escola, cidade inteira, município, conselho municipal, municipal, distrito, especial
Os valores aceitáveis são os seguintes:
|
|
contests[].district.id |
string |
Um identificador do distrito, relativo ao escopo dele. Por exemplo, o 34o distrito do Senado Estadual teria o ID "34". e um escopo de stateUpper. | |
contests[].numberElected |
long |
O número de candidatos que serão eleitos para o cargo no concurso. | |
contests[].numberVotingFor |
long |
O número de candidatos em que um eleitor pode votar no concurso. | |
contests[].ballotPlacement |
long |
Um número que especifica a posição da disputa na cédula do eleitor. | |
contests[].candidates[] |
list |
As opções de candidatos deste concurso. | |
contests[].candidates[].name |
string |
O nome do candidato. | |
contests[].candidates[].party |
string |
O nome completo do partido do qual o candidato é membro. | |
contests[].candidates[].candidateUrl |
string |
O URL do site da campanha do candidato. | |
contests[].candidates[].phone |
string |
O número de telefone do escritório de campanha do candidato. | |
contests[].candidates[].photoUrl |
string |
Um URL para uma foto do candidato. | |
contests[].candidates[].email |
string |
O endereço de e-mail da campanha do candidato. | |
contests[].candidates[].orderOnBallot |
long |
A ordem em que o candidato aparece na cédula do concurso. | |
contests[].candidates[].channels[] |
list |
Uma lista de canais conhecidos de mídia social do candidato. | |
contests[].candidates[].channels[].type |
string |
O tipo de canal. Confira a seguir uma lista de tipos de canais, mas esta não é uma lista completa. Outros tipos de canal podem ser adicionados no futuro. Uma destas opções:
|
|
contests[].candidates[].channels[].id |
string |
O identificador público exclusivo do canal do candidato. | |
contests[].referendumTitle |
string |
O título do referendo (por exemplo, "Proposta 42"). Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumSubtitle |
string |
Uma breve descrição do referendo. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumUrl |
string |
Um link para o referendo. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumBrief |
string |
Especifica um breve resumo do referendo normalmente na cédula abaixo do título, mas acima do texto. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumText |
string |
O texto completo do referendo. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumProStatement |
string |
Uma declaração a favor do referendo. Ela não necessariamente aparece na cédula. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumConStatement |
string |
Uma declaração de oposição ao referendo. Ela não necessariamente aparece na cédula. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumPassageThreshold |
string |
O limite de votos necessário para aprovação do referendo, por exemplo, "dois terços". Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumEffectOfAbstain |
string |
Especifica o efeito da abstração (não votar) na proposta (ou seja, se a abstração é considerada um voto contra ela). Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumBallotResponses[] |
list |
O conjunto de respostas eleitorais para o referendo. Uma resposta à cédula representa uma linha na cédula. Exemplos comuns podem incluir "sim" ou "não" para referendos ou o nome de um juiz em um concurso de retenção. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].sources[] |
list |
Uma lista de fontes deste concurso. Se várias fontes estiverem listadas, os dados delas foram agregados. | |
contests[].sources[].name |
string |
Nome da fonte de dados. | |
contests[].sources[].official |
boolean |
Se esses dados vêm de uma fonte governamental oficial. |
Autoridades eleitorais
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
state[] |
list |
Informações eleitorais locais do estado em que o eleitor vota. Para os EUA, haverá apenas um elemento nessa matriz. | |
state[].name |
string |
O nome da jurisdição. | |
state[].electionAdministrationBody |
nested object |
O órgão de administração eleitoral da área. | |
state[].electionAdministrationBody.name |
string |
O nome desse órgão administrativo eleitoral. | |
state[].electionAdministrationBody.electionInfoUrl |
string |
Um URL fornecido por esse órgão administrativo para pesquisa de informações gerais sobre as eleições. | |
state[].electionAdministrationBody.electionRegistrationUrl |
string |
Um URL fornecido por esse órgão administrativo para procurar como se cadastrar para votar. | |
state[].electionAdministrationBody.electionRegistrationConfirmationUrl |
string |
Um URL fornecido por esse órgão administrativo para confirmar que o eleitor está registrado para votar. | |
state[].electionAdministrationBody.electionNoticeText |
string |
Um texto de notificação de emergência ou de última hora fornecido por esse órgão administrativo. | |
state[].electionAdministrationBody.electionNoticeUrl |
string |
Um URL fornecido por esse órgão administrativo para informações adicionais relacionadas à notificação de última hora ou de emergência. | |
state[].electionAdministrationBody.absenteeVotingInfoUrl |
string |
Um URL fornecido por esse órgão administrativo para informações sobre o voto em ausência. | |
state[].electionAdministrationBody.votingLocationFinderUrl |
string |
Um URL fornecido por esse órgão administrativo para procurar onde votar. | |
state[].electionAdministrationBody.ballotInfoUrl |
string |
Um URL fornecido por esse órgão administrativo para fornecer informações sobre o concurso ao eleitor. | |
state[].electionAdministrationBody.electionRulesUrl |
string |
Um URL fornecido por esse órgão administrativo que descreve as regras eleitorais para o eleitor. | |
state[].electionAdministrationBody.voter_services[] |
list |
Uma descrição dos serviços que esse órgão administrativo pode fornecer. | |
state[].electionAdministrationBody.hoursOfOperation |
string |
Uma descrição do horário de funcionamento desse órgão administrativo. | |
state[].electionAdministrationBody.correspondenceAddress |
nested object |
O endereço de correspondência desse corpo administrativo. | |
state[].electionAdministrationBody.correspondenceAddress.locationName |
string |
Nome do local. | |
state[].electionAdministrationBody.correspondenceAddress.line1 |
string |
O nome da rua e o número desse endereço. | |
state[].electionAdministrationBody.correspondenceAddress.line2 |
string |
A segunda linha, o endereço, se necessário. | |
state[].electionAdministrationBody.correspondenceAddress.line3 |
string |
A terceira linha do endereço, se necessário. | |
state[].electionAdministrationBody.correspondenceAddress.city |
string |
A cidade do endereço. | |
state[].electionAdministrationBody.correspondenceAddress.state |
string |
A abreviação de estado com duas letras dos EUA do endereço. | |
state[].electionAdministrationBody.correspondenceAddress.zip |
string |
O CEP do endereço nos EUA. | |
state[].electionAdministrationBody.physicalAddress |
nested object |
O endereço físico desse órgão administrativo. | |
state[].electionAdministrationBody.physicalAddress.locationName |
string |
Nome do local. | |
state[].electionAdministrationBody.physicalAddress.line1 |
string |
O nome da rua e o número desse endereço. | |
state[].electionAdministrationBody.physicalAddress.line2 |
string |
A segunda linha, o endereço, se necessário. | |
state[].electionAdministrationBody.physicalAddress.line3 |
string |
A terceira linha do endereço, se necessário. | |
state[].electionAdministrationBody.physicalAddress.city |
string |
A cidade do endereço. | |
state[].electionAdministrationBody.physicalAddress.state |
string |
A abreviação de estado com duas letras dos EUA do endereço. | |
state[].electionAdministrationBody.physicalAddress.zip |
string |
O CEP do endereço nos EUA. | |
state[].electionAdministrationBody.electionOfficials[] |
list |
Os funcionários eleitorais do órgão administrativo eleitoral. | |
state[].electionAdministrationBody.electionOfficials[].name |
string |
O nome completo do funcionário da eleição. | |
state[].electionAdministrationBody.electionOfficials[].title |
string |
O título do funcionário da eleição. | |
state[].electionAdministrationBody.electionOfficials[].officePhoneNumber |
string |
O número de telefone do escritório do funcionário eleitoral. | |
state[].electionAdministrationBody.electionOfficials[].faxNumber |
string |
O número de fax do funcionário eleitoral. | |
state[].electionAdministrationBody.electionOfficials[].emailAddress |
string |
O endereço de e-mail do funcionário da eleição. | |
state[].local_jurisdiction |
nested object |
A cidade ou o condado que fornece informações eleitorais para esse eleitor. Esse objeto pode ter os mesmos elementos do estado. | |
state[].sources[] |
list |
Uma lista de fontes desta área. Se várias fontes estiverem listadas, os dados foram agregados delas. | |
state[].sources[].name |
string |
Nome da fonte de dados. | |
state[].sources[].official |
boolean |
Se esses dados vêm de uma fonte governamental oficial. |