Gerador de Endereço Aleatório (Brasil)

Endereço brasileiro: anatomia e dados mock

Um endereço residencial brasileiro segue uma ordem rígida que vale memorizar: logradouro + número + complemento + bairro + cidade - UF + CEP. O logradouro é o tipo e nome da via; o número é o número da porta; o complemento é o detalhe de apartamento, bloco ou andar; o bairro é informação essencial (diferente de um ZIP americano); UF é a sigla de duas letras do estado; CEP é o código postal de 8 dígitos no formato XXXXX-XXX. Esquecer o bairro ou formatar o CEP sem o hífen quebra a maioria dos sistemas de entrega e vários formulários federais.

O Brasil tem 8,5 milhões de km² distribuídos em 5.570 municípios e 26 estados mais o Distrito Federal, com cerca de 150 mil logradouros únicos registrados no CNEFE (Cadastro Nacional de Endereços para Fins Estatísticos) do IBGE. Qualquer gerador mock realista precisa manter CEP, cidade e UF coerentes entre si — um CEP 01310-100 é da Avenida Paulista em São Paulo e não pode aparecer ao lado de "Manaus, AM" sem quebrar validações.

Tipos de logradouro e casos de borda

• Rua (~65% dos registros) e Avenida (~15%) são os tipos dominantes.
• Alameda, Travessa, Beco, Largo, Praça, Vila, Estrada, Rodovia (BR-101, SP-070), Viaduto e Conjunto Habitacional são variantes comuns.
• S/N ("sem número") é válido em endereços rurais e institucionais sem numeração.
• KM 10 substitui o número da porta em endereços rodoviários.
• Exemplos de complemento: Apto 502, Bloco B Apto 12, Casa, Térreo, Fundos, Loja 1.
• Favelas costumam usar numeração alternativa — becos numerados, subnúmeros tipo 123A, 123 fundos — que geradores mock genéricos quase sempre ignoram.

Validar se o mock parece real

Duas APIs gratuitas servem para sanity check. O ViaCEP (viacep.com.br/ws/{cep}/json/) retorna o logradouro, bairro, cidade e UF canônicos de qualquer CEP real — útil para pegar combinação CEP-vs-estado errada em dados fake. O BrasilAPI expõe os mesmos dados com metadados adicionais. Para geocoding com lat/long use OpenStreetMap Nominatim, Google Maps ou Mapbox; os dois últimos cobram, mas entendem melhor endereços coloquiais brasileiros. Para lotes muito grandes, o dump do CNEFE (grátis, ~5 GB CSV) traz cada endereço registrado como referência absoluta.

Para que servem endereços brasileiros fake

Endereços mock servem para popular testes de entrega em e-commerce, povoar ambientes de staging do CRM, validar formulários (incluindo o autocomplete por CEP que quase todo e-commerce BR usa), rodar testes de carga em calculadoras de frete (Correios, Loggi, Jadlog, Mercado Envios) e estressar regras antifraude. Pela LGPD um endereço residencial real é dado pessoal com risco de atribuição, então gerar endereços sintéticos é o caminho mais seguro para qualquer ambiente não produtivo. Só lembre que sintético não significa "qualquer coisa": coerência CEP-cidade-UF é requisito duro para teste de carga realista.

FAQ

Posso usar estes endereços para testar integração de entrega?

Para cálculo de frete (preço e prazo baseado em CEP-CEP), sim — o CEP gerado é válido em formato e bate com cidade real, então as calculadoras respondem. Para entrega real, não: o número e o complemento são aleatórios e o pacote não chega. Use um endpoint sandbox da transportadora.

A ferramenta gera endereços rurais?

Sim, o gerador inclui padrões rurais como S/N, marcadores KM e nomes de sítio/fazenda quando faz sentido. CEPs rurais brasileiros costumam terminar em -000 e cobrem a cidade inteira em vez de uma rua específica.

Como garantir que o CEP combina com a UF?

Os prefixos de CEP no Brasil seguem regiões geográficas — 0xxxx para São Paulo capital, 2xxxx para o Rio de Janeiro, 5xxxx para Pernambuco etc. Este gerador prende a região do CEP à UF escolhida para manter a combinação coerente. Para garantia extra, valide o resultado no ViaCEP.

Gerar dado pessoal fake é legal pela LGPD?

Dado sintético sem vínculo a pessoa real fica fora da definição de dado pessoal da LGPD. Endereços mock gerados aqui são seguros para teste e demo — o que aciona a LGPD é reaproveitar endereços reais coletados em vazamento ou base de cliente real.