API Geocodificação (Versão 1)

Versão em Depreciação

Essa versão da API de Geocodificação está em depreciação e será descontinuada em 28/02/2026. Migre para a Versão 2.

Introdução

Esta API permite consultar a latitude e longitude de um endereço, também conhecido como geocodificação, em inglês, "geocode" ou "geocoding".

Consulta as coordenadas geográficas de um endereço específico.

GET /api/v1/geocodificacao/consultar

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
`endereco`	Texto	Sim	Endereço para consulta	`RUA EXEMPLO, 123, SAO PAULO, SP`

Campo	Tipo	Descrição	Exemplo
`endereco_formatado`	Texto	Endereço formatado e normalizado	`"Rua Exemplo, São Paulo, SP"`
`latitude`	Número	Latitude do endereço	`-23.1234567`
`longitude`	Número	Longitude do endereço	`-46.1234567`

Código HTTP	Erro	Mensagem
`400`	`REQUISICAO_INVALIDA`
`403`	`PLANO_INATIVO`	`Plano inativo para realizar consultas.`
`403`	`CREDITOS_INSUFICIENTES`	`Sem créditos suficientes para consulta.`
`404`	`NAO_ENCONTRADO`	`Nenhum registro encontrado com os parâmetros informados.`

curl -X GET 'https://consultar.io/api/v1/geocodificacao/consultar?endereco=RUA+EXEMPLO,+123,SAO+PAULO,+SP' -H 'Authorization: Token <seu-token>'

{
  "endereco_formatado": "Rua Exemplo, São Paulo, SP",
  "latitude": -23.1234567,
  "longitude": -46.1234567
}

{
  "error": "NAO_ENCONTRADO",
  "message": "Nenhum registro foi encontrado para os parâmetros informados."
}

Recomendamos informar pelo menos Logradouro, Número (se houver), Município e UF.
Não recomendamos informar Complemento, Bairro e CEP.
Não recomendamos usar abreviações.