- São ZIP codes reais ou só cinco dígitos aleatórios?
- Reais. Todo código vem de um conjunto de dados embutido com ZIP codes atualmente atribuídos nos EUA, mostrado com a cidade e o estado que ele realmente atende. Isso importa mais do que parece: a maioria das páginas que respondem essa busca gera cinco dígitos na hora, o que significa que cerca de quatro em cada cinco códigos que elas entregam nunca foram atribuídos a lugar nenhum. Cole um num formulário de checkout ou num CRM com validação de endereço e ele volta. Essa diferença é o motivo inteiro de esta ferramenta existir.
- Como vocês sabem que os ZIPs são reais?
- Duas fontes independentes tiveram que concordar antes de uma única linha entrar. Os códigos vêm de um conjunto de dados público derivado do USPS e do Census. Separadamente, a tabela por estado das faixas de prefixo de 3 dígitos do USPS — Massachusetts é 010–027, Califórnia é 900–961, Nova York é 100–149 mais alguns códigos únicos — foi escrita a partir da alocação publicada, e não derivada daquele conjunto, e depois rodada sobre todas as 42.366 linhas de origem. 42.361 bateram. As cinco que não bateram estão nomeadas num comentário no código e ficaram de fora. Um teste refaz essa conferência de prefixo em toda linha publicada a cada build, então um código acrescentado à mão não consegue pular a verificação.
- Por que 02134 mantém o zero à esquerda aqui, se as planilhas perdem?
- Porque um ZIP code é texto que por acaso parece número, e ele é guardado e tratado como texto em todo lugar nesta ferramenta — no conjunto de dados, no que aparece na tela e no que vai para a sua área de transferência. No momento em que algo trata 02134 como número, ele vira 2134, que não é ZIP code nenhum. As planilhas fazem isso por padrão ao colar, e é por isso que o formato CSV aqui coloca aspas em todos os campos e há um aviso lembrando de colar numa coluna de texto. Todo código da Nova Inglaterra, de Nova Jersey e de Porto Rico começa com zero, então isso não é um caso raro — é um quinto do país.
- Posso pegar ZIP codes de um estado específico?
- Pode. Escolha o estado na lista e todo código sorteado pertence a ele, com uma cidade daquele estado embaixo. Esse é o modo útil para testar um formulário que valida o campo de estado contra o ZIP, ou para montar dados de teste em que o endereço precisa ser coerente. Estados menores têm menos códigos — se você pedir 50 códigos do Wyoming e só houver 18, recebe os 18 e um aviso dizendo isso, em vez de uma lista inchada com repetições.
- E Porto Rico, Guam e os outros territórios?
- Eles estão na lista e devolvem códigos reais — 006xx–009xx de Porto Rico, 969xx de Guam, e assim por diante. Mas ficam de fora, de propósito, da opção Qualquer. Quem digita “zip code aleatório” quase nunca quer dizer Guam, e códigos de território falham na validação de uma boa parte dos formulários de endereço só para os EUA, então receber um por acaso quando você queria um código americano genérico seria uma surpresa pequena e chata. Selecione o território explicitamente e ele vem.
- Quantos posso gerar de uma vez?
- Até 50 por lote, sem conta e sem pedido de upgrade. Cada código dentro de um lote é distinto — você nunca recebe o mesmo ZIP duas vezes numa lista —, e apertar Gerar de novo sorteia um conjunto novo que exclui o que você estava vendo. Baixar a quantidade de 50 para 5 mantém os cinco primeiros e limpa o resto, em vez de sortear tudo de novo. As plataformas de dados de teste que têm ZIPs reais limitam o plano gratuito a algumas centenas de linhas e cobram para liberar; aqui não há nada para liberar.
- Ele gera códigos ZIP+4?
- Não, e isso é proposital. O complemento de quatro dígitos identifica uma quadra, um prédio ou um grupo de caixas postais específico — não há como inventar um que seja ao mesmo tempo plausível e correto. Uma ferramenta cuja proposta inteira é “estes são reais” não deveria mostrar um código real de cinco dígitos ao lado de quatro dígitos inventados, porque o resultado parece mais confiável do que é e vai falhar na validação de ponto de entrega. Cinco dígitos reais é a resposta honesta.
- Para que eu posso usar estes códigos?
- Para popular um banco de dados de teste ou um ambiente de homologação com endereços que passam na validação. Para preencher um formulário de cadastro que você está testando sem digitar 02134 quarenta vezes. Para montar uma aula de geografia em que os alunos descobrem onde um código fica. Para amostrar mercados e ter uma distribuição aproximada de onde testar algo. O que eles não servem é para fingir estar onde você não está — um ZIP real pertence a um lugar real, e usá-lo para burlar uma restrição geográfica ou falsear um endereço de entrega é uma má ideia e não é para isso que a ferramenta foi feita.
- Algo é enviado para um servidor?
- Não. O conjunto de dados vem junto com a página e o sorteio roda no seu navegador usando crypto.getRandomValues — a mesma fonte de aleatoriedade de um gerador de senhas, com amostragem por rejeição para nenhum código levar vantagem sobre outro. Não há chamada de API, chave, conta nem registro do que você gerou. Desligue a internet depois que a página carregar e a ferramenta continua funcionando.
