Repolode
Enviar
daimon3332

daimon3332/address

Gerador de endereços self-hosted que retorna endereços reais de registros oficiais e dados de mapas abertos de 27 países e regiões.

Ver no GitHubSite
Estrelas
2,132
Forks
336
Issues abertas
1
Último commit
há 3 dias

O que é?

O Address gera endereços para testes e demonstrações que correspondem a locais reais, em vez de strings montadas aleatoriamente. Cada registro vem de um cadastro oficial de endereços, de dados de mapas abertos ou de um resultado de geocodificação validado, e inclui sua fonte, precisão e coordenadas. Campos sem dados ficam vazios, em vez de serem preenchidos artificialmente.

O projeto é implantado com um único arquivo Docker Compose que executa o app web, o PostgreSQL, as migrações e um serviço de sincronização em segundo plano. Oferece filtros por região, cidade, distrito e código postal que seguem a hierarquia administrativa de cada país, saída em dez idiomas de exibição e um console de administração para gerenciar fontes, tokens de API e controle de acesso. Uma API JSON autenticada com Bearer oferece geração individual e em lote, busca de locais, consultas de cobertura e tradução de endereços, além de um documento OpenAPI 3.1.

Os endereços podem ser copiados, exportados, salvos ou abertos no Google Maps ou no AMap. Chaves opcionais de terceiros ampliam os dados de países específicos ou habilitam a tradução online.

Recursos principais

  • 01Abrange 27 países e regiões, com filtros que seguem a hierarquia administrativa de cada país.
  • 02Cada endereço inclui a fonte, a precisão da correspondência e as coordenadas.
  • 03A saída está disponível em dez idiomas de exibição, incluindo vários idiomas chineses, japonês, coreano e idiomas europeus.
  • 04Sincronização incremental em segundo plano, com limites de tentativas e detecção de esgotamento das fontes.
  • 05API autenticada com Bearer para geração individual e em lote, busca de locais e tradução.
  • 06Implantação com um único Docker Compose, que gera os próprios segredos na primeira inicialização.

Casos de uso

  • Preencher formulários de checkout e cadastro com dados de teste.
  • Validar formatos de endereço em vários países.
  • Criar endereços realistas para demonstrações de logística ou mapeamento.
  • Gerar lotes de endereços pela API para pipelines de teste.

Início rápido

  1. 1

    Baixe o arquivo do Docker Compose

    curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml
  2. 2

    Inicie todos os serviços

    docker compose up -d
  3. 3

    Verifique se está pronto

    curl -fsS http://127.0.0.1:8787/api/v1/ready

Antes de usar

  • Requer Linux (AMD64 ou ARM64) com Docker Engine 24 ou superior e Compose v2.
  • São necessários pelo menos 4 GB de RAM. Para a primeira importação de países com muitos dados, recomenda-se ter 8 GB ou mais.
  • Os conjuntos de dados de origem têm suas próprias licenças e exigências de atribuição.

Em coleções

Apps auto-hospedados

Tópicos

#address-generation#mock-data#test-data#self-hosted#geocoding#openstreetmap#docker#api#address#address-generator

Perguntas frequentes

O que é address?
Gerador de endereços self-hosted que retorna endereços reais de registros oficiais e dados de mapas abertos de 27 países e regiões. O Address gera endereços para testes e demonstrações que correspondem a locais reais, em vez de strings montadas aleatoriamente. Cada registro vem de um cadastro oficial de endereços, de dados de mapas abertos ou de um resultado de geocodificação validado, e inclui sua fonte, precisão e coordenadas. Campos sem dados ficam vazios, em vez de serem preenchidos artificialmente.
address é gratuito? Qual é a licença?
address é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
address ainda é mantido?
Manutenção ativa. O último commit de address foi em 4 de nov. de 2026.
Para que posso usar address?
Preencher formulários de checkout e cadastro com dados de teste. Validar formatos de endereço em vários países. Criar endereços realistas para demonstrações de logística ou mapeamento. Gerar lotes de endereços pela API para pipelines de teste.
Como instalar address?
Baixe o arquivo do Docker Compose: curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml Inicie todos os serviços: docker compose up -d Verifique se está pronto: curl -fsS http://127.0.0.1:8787/api/v1/ready
Onde consigo address?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/daimon3332/address

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados