Skip to content

devix-tecnologia/directus-extension-endereco-br

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Banner da Extensão de Endereços do Brasil para Directus

Extensão do Directus para Endereços Brasileiros

Crie, organize, pesquise e georreferencie endereços brasileiros de forma fácil e eficiente

Versão npm Licença Compatível com Directus

🎯 Compatibilidade

Esta extensão é totalmente compatível com:

  • Directus 10.x (a partir de 10.3.4)
  • Directus 11.x (todas as versões)

A extensão detecta automaticamente a versão do Directus e adapta seu comportamento para garantir compatibilidade total. Você pode atualizar do Directus 10 para 11 sem precisar alterar a extensão.

✨ Funcionalidades

🔍 Pesquisa por CEP

Agilize o cadastro de endereços permitindo pesquisar a partir do CEP para buscar automaticamente:

  • Logradouro
  • Bairro
  • Cidade
  • Estado
  • Código IBGE

⚙️ Configuração Automática

Toda a estrutura necessária é criada instantaneamente:

  • Coleções e relacionamentos são configurados durante a instalação
  • Lista completa dos estados brasileiros é inserida no banco de dados
  • Interface amigável pronta para uso

📍 Georreferenciamento

Localize endereços precisamente:

  • Armazena latitude e longitude dos endereços
  • Integração com os principais provedores de geolocalização
  • Visualização em mapa

🛠️ Configuração

Provedores de Georreferenciamento

Configure as seguintes variáveis de ambiente para habilitar o georreferenciamento:

Variável Descrição Valores Aceitos
GEOLOCATION_PROVIDER Provedor de geolocalização 'google' ou 'mapbox'
GEOLOCATION_AUTH_TOKEN Token de autenticação da API escolhida Seu token de API

Provedores Suportados

  • Google Maps Platform - API completa de geolocalização e visualização de mapas
  • Mapbox - Plataforma precisa de dados de localização

📦 Instalação

Via Marketplace (Recomendado)

A partir da versão 10.10 do Directus:

  1. Acesse o painel administrativo do Directus
  2. Navegue até Configurações → Marketplace
  3. Pesquise por endereco-br
  4. Clique em "Instalar"

Via NPM

npm install directus-extension-endereco-br

🖼️ Screenshots

Pesquisa por CEP

Pesquisa por CEP Faça a pesquisa por CEP e selecione o endereço rapidamente

Preenchimento de Informações Adicionais

Preenchimento de Informações Adicionais Preencha informações adicionais para completar o cadastro

Preenchimento Automático

Preenchimento Automático Ao salvar, os principais campos são preenchidos com os dados da pesquisa automática

Georreferenciamento

Georreferenciamento Georreferenciamento do endereço quando configurado

Cadastro Automático

Cadastro Automático Cadastro automático de bairro e cidades incluindo informações do IBGE

🤝 Contribuição

Contribuições são bem-vindas! Para contribuir com código, consulte o Guia de Contribuição com instruções detalhadas sobre desenvolvimento, testes e padrões de código.

Para reportar bugs ou sugerir funcionalidades, abra uma issue.

📄 Licença

MIT

👥 Autores


Desenvolvido com ❤️ por Devix Tecnologia

About

Cria, organiza, pesquisa e georeferência endereços brasileiros

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors