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 https://consultar.io/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`

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."
}

Código	Erro (error)	Descrição
`400`	`REQUISICAO_INVALIDA`	Veja a mensagem de erro (message) para mais detalhes.
`403`	`PLANO_INATIVO`	Plano inativo. Faça uma Recarga.
`403`	`CREDITOS_INSUFICIENTES`	Créditos insuficientes. Faça uma Recarga.
`404`	`NAO_ENCONTRADO`	Registro não encontrado.
`500`	`ERRO`	Veja a mensagem de erro (message) para mais detalhes.
`500`	`ERRO_INTERNO`	Ocorreu um erro inesperado no nosso sistema.
`503`	`SERVICO_INDISPONIVEL`	Veja a mensagem de erro (message) para mais detalhes.

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.