GET/v1/geocode

Geocoding

Converte um endereço em coordenadas com precisão de telhado na maioria dos centros urbanos brasileiros. Aceita endereços incompletos e faz correção automática de abreviações (Av., R., Trav.).

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Descrição
address	string	sim	Endereço em texto livre. Ex: Av. Paulista, 1578, São Paulo, SP.
country	string	não	Código ISO do país para restringir a busca. Padrão: BR.
limit	number	não	Máximo de resultados, entre 1 e 10. Padrão: 1.

Exemplo de requisição

curl "https://api.bussola.dev/v1/geocode?address=Av.+Paulista,+1578,+Sao+Paulo,+SP" \
  -H "Authorization: Bearer $BUSSOLA_API_KEY"

Resposta · 200 OK

{
  "lat": -23.561414,
  "lng": -46.655881,
  "precision": "rooftop",
  "formatted": "Av. Paulista, 1578 - Bela Vista, São Paulo - SP, 01310-200",
  "components": {
    "street": "Avenida Paulista",
    "number": "1578",
    "district": "Bela Vista",
    "city": "São Paulo",
    "state": "SP",
    "postal_code": "01310-200"
  }
}

Testar agora

sandbox

Endereço

Visualização no mapa

-23.550520, -46.633308 · zoom 15

Bússola Maps