directus-extension-endereco-br
v1.4.2
Published
Extensão do Directus para trabalhar com endereços brasileiros, incluindo CEP, estados, cidades, bairros e geolocalização
Maintainers
sidartavelosoReadme
Extensão do Directus para Endereços Brasileiros
Crie, organize, pesquise e georreferencie endereços brasileiros de forma fácil e eficiente
✨ 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:
- Acesse o painel administrativo do Directus
- Navegue até
Configurações → Marketplace - Pesquise por
endereco-br - Clique em "Instalar"
Via NPM
npm install directus-extension-endereco-br🖼️ Screenshots
Pesquisa por CEP
Faça a pesquisa por CEP e selecione o endereço rapidamente
Preenchimento de Informações Adicionais
Preencha informações adicionais para completar o cadastro
Preenchimento Automático
Ao salvar, os principais campos são preenchidos com os dados da pesquisa automática
Georreferenciamento
Georreferenciamento do endereço quando configurado
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.