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 antecipadas) para um determinado endereço residencial
- Informações sobre o concurso e o candidato
- Informações sobre as 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 pesquisado. |
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 ID da eleição for especificado na consulta e houver mais de uma eleição com dados do eleitor em questão, as eleições adicionais serão fornecidas no campo de resposta Se não houver uma eleição em tempo real para o endereço informado, a resposta só vai retornar os dados se o ID da eleição for especificado. Recomendamos, neste caso, que qualquer ferramenta faça uma segunda consulta com o ID da eleição especificado para garantir que o local de votação, o concurso e as informações oficiais da eleição (quando aplicável) sejam fornecidos ao usuário. |
officialOnly |
boolean |
Se definido como verdadeiro, somente 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 retornará as informações de votação da primeira ou mais recente eleição. Se a primeira eleição não for a pretendida, especifique o ID da eleição desejada em uma segunda solicitação de API usando o campo electionId .2. Se essas eleições ocorrerem no mesmo dia, a API não retornará nenhuma informação sobre local de votação, concurso ou representante eleitoral para garantir que uma consulta adicional seja feita. No caso de apps voltados ao usuário, recomendamos exibir essas eleições ao usuário para eliminar a ambiguidade. Uma segunda solicitação de API usando o campo electionId precisa ser feita para a escolha relevante ao 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 do 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 duas letras do endereço nos EUA. | |
normalizedInput.zip |
string |
O CEP do endereço nos EUA. | |
mailOnly |
boolean |
Especifica se os eleitores no distrito votam apenas enviando suas cédulas pelo correio (com a possível opção de também recusar suas cédulas). |
Locais de votação, de voto antecipado e de entrega
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 do 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 duas letras do endereço nos EUA. | |
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 a ser usada). | |
pollingLocations[].pollingHours |
string |
Uma descrição de quando o local está aberto. | |
pollingLocations[].name |
string |
O nome do site de voto antecipado ou local de desembarque. Este campo não é preenchido para locais de votação. | |
pollingLocations[].voterServices |
string |
Os serviços fornecidos pelo site de votação antecipada ou local de desembarque. Este campo não é preenchido para locais de votação. | |
pollingLocations[].startDate |
string |
A primeira data em que esse site de voto antecipado ou local de desembarque pode ser usado. Este campo não é preenchido para locais de votação. | |
pollingLocations[].endDate |
string |
A última data em que esse site de voto antecipado ou local de entrega pode ser usado. Este campo não é preenchido para locais de votação. | |
pollingLocations[].latitude |
string |
Latitude do local, em graus ao norte 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 para este local. Se várias fontes estiverem listadas, os dados foram agregados a partir delas. | |
pollingLocations[].sources[].name |
string |
O nome da fonte de dados. | |
pollingLocations[].sources[].official |
boolean |
Indica se esses dados vêm de uma fonte governamental oficial. | |
earlyVoteSites[] |
list |
Locais em que o eleitor pode votar 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 do 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 duas letras do endereço nos EUA. | |
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 a ser usada). | |
earlyVoteSites[].pollingHours |
string |
Uma descrição de quando o local está aberto. | |
earlyVoteSites[].name |
string |
O nome do site de voto antecipado ou local de desembarque. Este campo não é preenchido para locais de votação. | |
earlyVoteSites[].voterServices |
string |
Os serviços fornecidos pelo site de votação antecipada ou local de desembarque. Este campo não é preenchido para locais de votação. | |
earlyVoteSites[].startDate |
string |
A primeira data em que esse site de voto antecipado ou local de desembarque pode ser usado. Este campo não é preenchido para locais de votação. | |
earlyVoteSites[].endDate |
string |
A última data em que esse site de voto antecipado ou local de entrega pode ser usado. Este campo não é preenchido para locais de votação. | |
earlyVoteSites[].latitude |
string |
Latitude do local, em graus ao norte 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 para este local. Se várias fontes estiverem listadas, os dados foram agregados a partir delas. | |
earlyVoteSites[].sources[].name |
string |
O nome da fonte de dados. | |
earlyVoteSites[].sources[].official |
boolean |
Indica se esses dados vêm de uma fonte governamental oficial. | |
dropOffLocations[] |
list |
Locais em que um eleitor se qualifica para votar. O eleitor deve ter recebido e concluído uma cédula de votação antes de chegar ao local. O local pode não ter cédulas disponíveis no local. Esses locais podem estar abertos até o dia da eleição, conforme indicado no campo "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 do 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 duas letras do endereço nos EUA. | |
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 a ser usada). | |
dropOffLocations[].pollingHours |
string |
Uma descrição de quando o local está aberto. | |
dropOffLocations[].name |
string |
O nome do site de voto antecipado ou local de desembarque. Este campo não é preenchido para locais de votação. | |
dropOffLocations[].voterServices |
string |
Os serviços fornecidos pelo site de votação antecipada ou local de desembarque. Este campo não é preenchido para locais de votação. | |
dropOffLocations[].startDate |
string |
A primeira data em que esse site de voto antecipado ou local de desembarque pode ser usado. Este campo não é preenchido para locais de votação. | |
dropOffLocations[].endDate |
string |
A última data em que esse site de voto antecipado ou local de entrega pode ser usado. Este campo não é preenchido para locais de votação. | |
dropOffLocations[].latitude |
string |
Latitude do local, em graus ao norte 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 para este local. Se várias fontes estiverem listadas, os dados foram agregados a partir delas. | |
dropOffLocations[].sources[].name |
string |
O nome da fonte de dados. | |
dropOffLocations[].sources[].official |
boolean |
Indica se esses dados vêm de uma fonte governamental oficial. |
Concursos
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
contests[] |
list |
Concursos que vão aparecer na cédula de votação do eleitor. | |
contests[].type |
string |
O tipo de concurso. Em geral, esse campo será "Geral", "Principal" ou "Salvamento" para concursos com candidatos. Para referendos, é "Referendum". | |
contests[].primaryParty |
string |
No caso de eleições partidárias, o nome do partido a que ele pertence. | |
contests[].electorateSpecifications |
string |
Uma descrição dos requisitos adicionais de qualificação para votar nesse concurso. | |
contests[].special |
string |
"Sim" ou "Não", dependendo se a competição é realizada fora do ciclo normal de eleições. | |
contests[].ballotTitle |
string |
O título oficial na cédula para este concurso, quando disponível. | |
contests[].office |
string |
O nome do escritório deste concurso. | |
contests[].level[] |
list |
Os níveis de governo referentes ao cargo deste concurso. Pode haver mais de um nos casos em que uma jurisdição atua efetivamente em dois níveis diferentes de governo. Por exemplo, o prefeito do Distrito de Colúmbia atua no nível locality , mas também de maneira eficaz em ambos administrativeArea2 e administrativeArea1 .Os valores válidos incluem:
|
|
contests[].roles[] |
list |
As funções a que o cargo este concurso está destinado. As funções não pretendem ser uma lista completa ou especificar exatamente todo o conjunto de responsabilidades de um determinado escritório, mas sim categorias gerais úteis para a seleção geral 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 deste distrito. Se não for especificada, a geografia do distrito é desconhecida. Uma destas opções: nacional, estadual, congressional, stateUpper, stateLower, todo o condado, judicial, escola, citywide, município, condado, conselho municipal, distrito, especial
Os valores aceitáveis são:
|
|
contests[].district.id |
string |
É um identificador do distrito em relação ao escopo dele. Por exemplo, o 34o distrito do Senado estadual teria ID "34" e o escopo stateUpper. | |
contests[].numberElected |
long |
O número de candidatos eleitos para o cargo neste concurso. | |
contests[].numberVotingFor |
long |
O número de candidatos em que um eleitor pode votar neste concurso. | |
contests[].ballotPlacement |
long |
Um número que especifica a posição desse concurso na cédula de votação do eleitor. | |
contests[].candidates[] |
list |
As escolhas do candidato para este concurso. | |
contests[].candidates[].name |
string |
O nome do candidato. | |
contests[].candidates[].party |
string |
O nome completo do partido de que 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 da 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 para esse concurso. | |
contests[].candidates[].channels[] |
list |
Uma lista dos canais de mídia social conhecidos do candidato. | |
contests[].candidates[].channels[].type |
string |
O tipo de canal. Veja a seguir uma lista dos tipos de canais, mas esta não é uma lista completa. Outros tipos de canais poderão ser adicionados depois. 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 que normalmente está no voto 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. Isso não aparece necessariamente na cédula. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumConStatement |
string |
Uma declaração em oposição ao referendo. Isso não aparece necessariamente na cédula. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].referendumPassageThreshold |
string |
O limiar de votos que o referendo precisa para ser aprovado, 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 votação) sobre a 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 à votação para o referendo. Uma resposta à votação representa uma linha na cédula. Exemplos comuns podem incluir "sim" ou "não" para referendos, ou o nome de um juiz para um concurso de retenção. Esse campo só é preenchido para concursos do tipo "Referendum". | |
contests[].sources[] |
list |
Uma lista de fontes para este concurso. Se várias origens estiverem listadas, os dados foram agregados a partir delas. | |
contests[].sources[].name |
string |
O nome da fonte de dados. | |
contests[].sources[].official |
boolean |
Indica se esses dados vêm de uma fonte governamental oficial. |
Funcionários das eleições
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 do órgão administrativo eleitoral. | |
state[].electionAdministrationBody.electionInfoUrl |
string |
Um URL fornecido por esse órgão administrativo para pesquisar informações gerais sobre as eleições. | |
state[].electionAdministrationBody.electionRegistrationUrl |
string |
Um URL fornecido pelo órgão administrativo para pesquisar como se cadastrar para votar. | |
state[].electionAdministrationBody.electionRegistrationConfirmationUrl |
string |
Um URL fornecido pelo órgão administrativo para confirmar que o eleitor está registrado para votar. | |
state[].electionAdministrationBody.electionNoticeText |
string |
Um texto de notificação de última hora ou de emergência 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 este órgão administrativo para informações sobre a votação em trânsito. | |
state[].electionAdministrationBody.votingLocationFinderUrl |
string |
Um URL fornecido pelo órgão administrativo para consultar onde votar. | |
state[].electionAdministrationBody.ballotInfoUrl |
string |
Um URL fornecido por esse órgão administrativo para fornecer informações do concurso ao eleitor. | |
state[].electionAdministrationBody.electionRulesUrl |
string |
Um URL fornecido por esse órgão administrativo que descreve as regras eleitorais ao 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 deste órgão administrativo. | |
state[].electionAdministrationBody.correspondenceAddress |
nested object |
O endereço de correspondência desse órgão administrativo. | |
state[].electionAdministrationBody.correspondenceAddress.locationName |
string |
Nome do local. | |
state[].electionAdministrationBody.correspondenceAddress.line1 |
string |
O nome da rua e o número do 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 duas letras do endereço nos EUA. | |
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 do 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 duas letras do endereço nos EUA. | |
state[].electionAdministrationBody.physicalAddress.zip |
string |
O CEP do endereço nos EUA. | |
state[].electionAdministrationBody.electionOfficials[] |
list |
Os funcionários eleitorais desse órgão administrativo eleitoral. | |
state[].electionAdministrationBody.electionOfficials[].name |
string |
O nome completo do funcionário eleitoral | |
state[].electionAdministrationBody.electionOfficials[].title |
string |
O cargo do funcionário eleitoral. | |
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 eleitoral. | |
state[].local_jurisdiction |
nested object |
A cidade ou condado que fornece informações eleitorais para esse eleitor. Este objeto pode ter os mesmos elementos que o estado. | |
state[].sources[] |
list |
Uma lista de fontes desta área. Se várias fontes estiverem listadas, os dados foram agregados a partir delas. | |
state[].sources[].name |
string |
O nome da fonte de dados. | |
state[].sources[].official |
boolean |
Indica se esses dados vêm de uma fonte governamental oficial. |