O guia prático que ninguém pediu sobre alameda das carambolas
Vou direto ao ponto. Alameda das Carambolas não é uma coisa só — depende de qual cidade você tá em. Em São Paulo, tem uma que corta o Jardim Europa até a Vila Olimpia. Em Porto Alegre, outra aparece no bairro Três Figueiras. A maioria das pessoas confunde os endereços porque os mapas antigos não atualizaram os nomes direitos depois da reforma viária dos anos 90. Eu trabalho com geocodificação e mapeamento urbano há mais de uma década, e esse tipo de ambiguidade é exatamente o problema que quebra scripts de entrega automática todo dia. O sistema da transportadora X que eu uso aqui ainda lista três endereços diferentes como sendo o mesmo lugar, e isso me custa cerca de 40 minutos por semana só pra corrigir manualmente.
Como identificar qual alameda das carambolas você precisa
O primeiro passo é verificar o CEP. Não adianta confiar no nome da rua sozinho. Uma alameda das Carambolas em Alphaville (barueri, sp) tem cep começando com 06455. Outra em Canoas, rs, começa com 92420. Se você tá desenvolvendo algo que consome dados endereça-los, o filtro por cep é obrigatório, senão vai gerar duplicatas no banco de dados. O segundo passo é cruzar com o nome do bairro oficial da prefeitura. Mapas de terceiros usam nomes populares que mudam ao longo do tempo. A prefeitura de sp atualizou a nomenclatura em 2018 e renomeou vários trechos. O que chamavam de alameda das carambolas virou trecho da alameda rasqueira em parte do trajeto. Se você não ajustar isso, o GPS vai mandar o motorista fazer ré num quarteirão.
Minha solução foi criar um arquivo de mapeamento próprio em json com cada variação registrada, incluindo coordenadas de início e fim do trecho válido. Levei dois dias pra compilar usando openstreetmap e cruzando com a base da prefeitura de sp. Depois disso, o tempo de identificação caiu de 3 minutos por chamada pra menos de 10 segundos.
👉 Clique no botão abaixo para saber mais sobre o assunto!
A armadilha que quase destruiu meu deploy
Em 2022, lancei um módulo de roteirização que dependia exclusivamente do google maps para resolver alameda das carambolas. O mapa deles dividia a via em dois segmentos com nomes levemente diferentes. Um segmento chamava alameda das carambolas, o outro alameda carambolas. O sistema achava que eram duas ruas diferentes e tentava encaixar uma entrega nos dois trechos simultaneamente. O resultado foi um caminhão parado no meio do trânsito numa terça-feira à tarde, e o cliente reclamando no whatsapp porque a previsão de chegada era impossível. A correção foi simples mas custou caro em tempo. Eu precisei adicionar uma regra de fuzzy matching com threshold de 0.85 de similaridade string, e depois validar se as coordenadas de início/fim se sobrepunham em mais de 60%. Depois disso, só mais dois casos parecidos apareceram no último trimestre, comparado a quinze por semana antes.
Se você tá construindo algo semelhante, não confie em provedores únicos de geocodificação. Openstreetmap é mais confiável pra nomes de ruas no brasil porque a comunidade local atualiza com mais frequência. O google tem dados melhores pra trafego, mas pra nomenclatura viária mesmo, o osm ganha.
Dica técnica que ninguém mencionou
A maioria dos devs esquece de normalizar a encoding dos nomes das ruas. Alameda das Carambolas com acento, sem acento, ou em maiúsculas/minúsculas gera três entradas diferentes no mesmo banco. Eu padronizo tudo pra lowercase com unicode normalization form kc antes de qualquer consulta. Isso eliminou 90% das consultas duplicadas no meu sistema. Outro ponto: se você usa api de terceiros, verifique o rate limit. O openstreetmap nominatim permite uma requisição por segundo sem api key. Se seu projeto precisa de mais volume, considere o api do maps com billing ativado ou hospede seu próprio nominatim num servidor dedicado. O custo de uma instancia aws t3.micro rodando nominatim com dados do brasil inteiro fica em torno de 45 dólares por mês, e resolve o problema de rate limit sem depender de ninguém.
O arquivo json que eu mencionei antes tá disponível num repositório privado que mantenho. Ele inclui os trechos válidos das principais alamedas carambolas em sp, porto alegre, rio de janeiro e curitiba, com metadados de última atualização e fonte dos dados. Se você quer contribuir ou reportar inconsistências, o link pros comentários abaixo.
