Normalizar endereço

warning

Em desenvolvimento - ainda não disponível em produção

Converte um endereço em texto livre (por exemplo, o que o munícipe falou ao telefone) em campos estruturados, com latitude e longitude. A consulta é feita no Google.

O resultado pode ser enviado no campo endereco de Criar Solicitação.

Endpoints

Método	URL
GET	https://{{url}}/cube/api/v3/enderecos?endereco={{endereco}}

Parâmetros

Chave	Tipo	Obrigatório	Descrição
endereco	String (query)	Sim	Endereço em texto livre, ex.: Rua Bela Cintra, 1149, São Paulo

Respostas

Exemplo de corpo da resposta

{
    "enderecoFormatado": "R. Bela Cintra, 1149 - Consolação, São Paulo - SP, 01415-001, Brasil",
    "logradouro": "Rua Bela Cintra",
    "numero": 1149,
    "bairro": "Consolação",
    "cidade": "São Paulo",
    "uf": "SP",
    "cep": "01415-001",
    "latitude": -23.5578,
    "longitude": -46.6626
}

Chave	Descrição
enderecoFormatado	Endereço completo como retornado pelo Google
logradouro, numero, bairro, cidade, uf, cep	Partes do endereço
latitude, longitude	Coordenadas do endereço

Status da resposta

Status	Descrição
200	OK - Retorna o endereço normalizado.
400	Parâmetro endereco não informado.
401	API Key, Secret ou Client ID inválidos.
429	Limite de requisições excedido.