Normalizar endereço
atenção
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. |