O endereço é o campo mais requisitado e o menos confiável de qualquer coleta em fonte pública.
Ele volta assim: "AV BRIG FARIA LIMA, 1234 - CJ 51 - JD PAULISTANO". Sem CEP, com abreviação criada por quem digitou, complemento no meio do logradouro e bairro que não existe mais com esse nome. Tecnicamente, o campo veio preenchido. Na prática, ele não serve para nada que dependa de posição.
Este artigo é sobre o que acontece entre esse texto e uma coordenada em que dá para confiar.
Por Que o Endereço Chega Ruim
Não é descuido do órgão. É a natureza do dado.
Foi digitado por uma pessoa, uma vez, há anos. Cadastro público costuma refletir o momento da inscrição, não o presente.
Cada fonte tem um formato. Uma devolve logradouro, número e complemento em campos separados; outra devolve tudo numa linha só; uma terceira devolve dentro de um PDF, no meio de um parágrafo.
Abreviação não tem padrão. "AV", "AVN", "AVEN", "AVENIDA" convivem na mesma base. O mesmo vale para "R", "RUA", "R.", e para todo tipo de logradouro.
O território muda e o cadastro não. Rua é renomeada, bairro é desmembrado, município é emancipado. O endereço continua correto para quem cadastrou e errado para quem consulta hoje.
As Quatro Etapas Entre o Texto e a Coordenada
1. Extração
Separar o que veio junto: logradouro, número, complemento, bairro, município, unidade federativa, CEP. Quando a fonte entrega tudo em um campo só, essa separação já é trabalho, e é onde a maior parte do erro nasce.
2. Normalização
Expandir abreviação, padronizar tipo de logradouro, corrigir acentuação, mover complemento para o campo certo. É a mesma disciplina de normalização que se aplica a qualquer campo coletado: o dado sai igual, venha de onde vier.
3. Validação contra base de referência
Confrontar o endereço normalizado com a referência oficial de endereçamento. É o que responde: esse logradouro existe nesse município? Esse CEP corresponde a esse bairro? Divergência aqui é sinal, não erro a ser escondido.
4. Geocodificação
Converter em coordenada. E aqui vem a parte que quase todo projeto pula.
Precisão Não É Sim ou Não
Um geocodificador quase sempre devolve uma coordenada. A pergunta certa não é "achou?", é "achou em qual nível?".
| Nível | O que significa | Serve para |
|---|---|---|
| Número | Ponto do imóvel | Roteirização, visita, entrega |
| Logradouro | Meio da rua | Análise de vizinhança, distância aproximada |
| CEP | Centroide da faixa | Agrupamento, densidade |
| Bairro | Centroide do bairro | Território, cobertura |
| Município | Centroide da cidade | Estatística, mapa de calor |
O defeito clássico é tratar tudo como igual. Uma coordenada no centroide do município tem a mesma cara de uma coordenada no número do imóvel: latitude e longitude, dois números. Usar uma no lugar da outra produz roteiro impossível e conclusão errada sobre distância.
Por isso a coordenada nunca deve ser entregue sozinha. Ela vem com nível de precisão e com o endereço normalizado que a originou. Sem esses dois acompanhantes, quem consome não tem como decidir se pode confiar.
O Que Fazer Com o Que Não Resolve
Nem todo endereço vira coordenada confiável, e insistir produz coisa pior que a ausência.
A regra é a mesma do resto da coleta: falha não pode virar resposta. Coordenada errada é mais cara que coordenada ausente, porque ninguém desconfia dela.
Onde Isso Vira Decisão de Negócio
Com endereço normalizado e precisão declarada, aparecem usos que o texto cru não permitia:
- Território e cobertura. Distribuição de clientes, fornecedores ou unidades por região, com agregação honesta por nível de precisão.
- Roteirização e visita. Só faz sentido a partir de precisão em nível de número.
- Conferência entre o declarado e o oficial. O endereço que o cliente informou bate com o que consta na fonte pública? Divergência é sinal operacional, não veredito.
- Concentração de risco. Exposição por região, quando a decisão depende de onde as coisas estão, e não só de quantas são.
Como Pedir Isso no Escopo
Três definições resolvem a maior parte da ambiguidade:
- Nível mínimo de precisão aceitável para cada uso. Roteirização exige número; mapa de calor aceita bairro.
- O que fazer com o não resolvido: devolver sem coordenada, marcar para revisão ou tentar fonte alternativa.
- Se o endereço declarado pelo cliente entra na comparação ou se só o da fonte pública vale.
Sem a primeira definição, o projeto entrega coordenada para tudo e a decepção aparece depois, no uso.
O diagnóstico que vale fazer primeiro
Se você já tem endereços vindos de coleta e nunca mediu a distribuição de precisão deles, esse é o primeiro diagnóstico: quantos por cento resolvem em nível de número, quantos param no bairro e quantos não resolvem.
Quer avaliar a sua base? O ponto de partida é uma amostra dos endereços como eles chegam hoje, antes de qualquer tratamento.
"Coordenada errada custa mais que coordenada ausente. Ninguém desconfia dela."