GET
/v1/reverseGeocodificação Reversa (GPS para Endereço)
Transforma coordenadas de latitude e longitude no endereço físico mais próximo, número do imóvel e CEP correspondente em tempo real.
Parâmetros da Requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| lat | Query (number) | Sim | Latitude decimal no padrão WGS84 (-90.0 a 90.0). |
| lon | Query (number) | Sim | Longitude decimal no padrão WGS84 (-180.0 a 180.0). |
| raio | Query (integer) | Opcional (Padrão: 50) | Raio máximo de busca em metros (limite máximo: 10.000m). |
Exemplos de Código
curl -s "https://api.geocep.api.br/v1/reverse?lat=-22.905531&lon=-43.177445&raio=500"🌐 Modo público: Gratuito até 100 requisições/hora por IP sem cadastro.HTTPS / TLS 1.3
Exemplo de Resposta (200 OK)
{
"status": "success",
"data": {
"cep": "20040-002",
"tipoLogradouro": "Avenida",
"logradouro": "Rio Branco",
"numeroProximo": "142",
"bairro": "Centro",
"cidade": "Rio de Janeiro",
"uf": "RJ",
"distanciaMetros": 3.45,
"coordenadas": {
"latitude": -22.905531,
"longitude": -43.177445,
"precisao": "numero_exato",
"fonte": "ibge_cnefe"
}
}
}