🗺️ OndeVou Endereços
Módulo fundamental da plataforma para gestão de endereços e localidades. 12 rotinas para gerenciar toda a hierarquia geográfica: país, região, UF, mesorregião, microrregião, cidade, bairro, CEP, rua e logradouros.
🗺️ App 0001
🌎 12 Rotinas
🏗️ Hierarquia Completa
📍 Integração com Mapas
🔗 Base para toda plataforma
12
Rotinas
11
Tabelas
🌎
Países
📍
CEPs
🎯 Visão Geral
🗺️ O que é o App Endereçamentos?
O App 0001 é o módulo fundamental de geolocalização da plataforma OndeVou. Ele estrutura toda a hierarquia de endereços que alimenta os demais módulos do sistema.
- 🌎 Países: Cadastro de países
- 🗺️ Regiões: Norte, Nordeste, etc.
- 🏛️ Estados (UF): Unidades federativas
- 📊 Mesorregiões/Microrregiões: Divisões do IBGE
- 🏙️ Cidades e Bairros: Localidades
- 📍 CEPs e Ruas: Endereços completos
🎯 Importância Estratégica
Este módulo é a base para toda a plataforma. Sem ele, nenhum outro app funciona corretamente:
- 👥 Participantes: Endereços de clientes/fornecedores
- 🚚 Rotas: Planejamento de entregas
- 📦 Entregas: Cálculo de fretes
- 📄 NF-e: Dados fiscais do destinatário
- 📊 Faturamento: Análise por região/UF/cidade
🎯 Diferencial: Hierarquia completa seguindo os padrões do IBGE e Correios.
🏗️ Hierarquia dos Endereços
Estrutura completa de localidades da plataforma
🌎 Nível 1 - País
Brasil, Estados Unidos, etc.
114 Países
🗺️ Nível 2 - Região
Norte, Nordeste, Centro-Oeste, Sudeste, Sul
115 Regiões
🏛️ Nível 3 - Estado (UF)
São Paulo, Rio de Janeiro, Bahia, etc.
116 Estados
📊 Nível 4 - Mesorregião
Divisão geoeconômica do IBGE
117 Mesorregiões
📊 Nível 5 - Microrregião
Agrupamento de municípios
118 Microrregiões
🏙️ Nível 6 - Cidade
Municípios e distritos
119 Cidades
🏘️ Nível 7 - Bairro
Bairros das cidades
120 Cidades e bairros
123 Nomes de bairros
📍 Nível 8 - CEP
Código de Endereçamento Postal
121 CEPs
🛣️ Nível 9 - Rua/Logradouro
Nomes de ruas, avenidas, praças, etc.
122 Ruas
124 Nomes de logradouros
🗺️ Nível 10 - Mapas
Visualização geográfica integrada
201 Mapas
🔗 Relacionamentos entre Tabelas
| Nível | Tabela | Referencia |
|---|---|---|
| 1 | pais | - |
| 2 | regioes | id_pais |
| 3 | uf | id_pais, id_regiao |
| 4 | uf_mesorregioes | id_uf |
| 5 | uf_microrregioes | id_mesorregiao |
| 6 | cidades | id_uf, id_microrregiao |
| 7 | cidades_bairros | id_cidade, id_bairro | 8 | ceps | id_cidade, id_bairro |
| 9 | ruas | id_cidade, id_bairro, id_cep |
🌎 Países, Regiões e Estados
🌎 Países
- 114 Países
- Cadastro de países
- Códigos IBGE e internacionais
🗺️ Regiões
- 115 Regiões
- Norte, Nordeste, etc.
- Vinculadas a um país
🏛️ Estados (UF)
- 116 Estados
- Sigla (SP, RJ, BA)
- Código IBGE
- Vinculado a país e região
📋 Tabela: uf
| Campo | Descrição |
|---|---|
| id_uf | Identificador único do estado |
| id_pais | País ao qual pertence |
| id_regiao | Região (Norte, Nordeste, etc.) |
| sigla | SP, RJ, BA, etc. |
| nome | Nome completo do estado |
| codigo_ibge | Código do IBGE |
📊 Mesorregiões e Microrregiões
Divisões geoeconômicas do IBGE para análises regionais
📊 Mesorregiões
- 117 Mesorregiões
- Agrupamento de microrregiões
- Base para análises econômicas
- Vinculado a um estado (UF)
📊 Microrregiões
- 118 Microrregiões
- Agrupamento de municípios
- Vinculado a uma mesorregião
- Utilizado em relatórios geográficos
📋 Tabela: uf_mesorregioes
| Campo | Descrição |
|---|---|
| id_mesorregiao | Identificador único |
| id_uf | Estado vinculado |
| nome | Nome da mesorregião |
| codigo_ibge | Código IBGE |
🏙️ Cidades e Bairros
🏙️ Cidades
- 119 Cidades
- Municípios e distritos
- Vinculado a UF e microrregião
- Código IBGE
🏘️ Bairros
- 120 Cidades e bairros (relacionamento)
- 123 Nomes de bairros (catálogo)
- Relacionamento N:N entre cidades e bairros
📋 Tabelas
| Tabela | Descrição |
|---|---|
| cidades | Cadastro de municípios com ID, nome, UF, código IBGE |
| bairros | Cadastro de nomes de bairros |
| cidades_bairros | Relacionamento N:N entre cidades e bairros |
📍 CEPs e Ruas
📍 CEPs
- 121 CEPs
- Código de Endereçamento Postal
- Vinculado a cidade e bairro
- Base para cálculo de frete
🛣️ Ruas e Logradouros
- 122 Ruas
- 124 Nomes de logradouros
- Vinculado a cidade, bairro e CEP
- Geolocalização (latitude/longitude)
📋 Tabela: ceps
| Campo | Descrição |
|---|---|
| id_cep | Identificador único |
| cep | Código postal (formato 00000-000) |
| id_cidade | Cidade vinculada |
| id_bairro | Bairro vinculado |
| latitude | Coordenada geográfica |
| longitude | Coordenada geográfica |
🗺️ Mapas
Visualização geográfica integrada com Google Maps
- 201 Mapas
- Visualização de endereços no mapa
- Geolocalização de participantes
- Traçado de rotas
- Integração com Google Maps API
🗺️ Funcionalidades: Busca de endereços, marcadores, rotas otimizadas, cálculo de distâncias, exportação KML.
📊 Rotinas do App 0001
12 rotinas para gestão completa de endereços
| Rotina | Nome | ID | Tabela | URL Amiga |
|---|---|---|---|---|
| 114 | Países | 1 | pais | enderecamentos_paises |
| 115 | Regiões | 2 | regioes | enderecamentos_regioes |
| 116 | Estados | 3 | uf | enderecamentos_estados |
| 117 | Mesorregiões | 4 | uf_mesorregioes | enderecamentos_mesorregioes |
| 118 | Microrregiões | 5 | uf_microrregioes | enderecamentos_microrregioes |
| 119 | Cidades | 6 | cidades | enderecamentos_cidades |
| 120 | Cidades e bairros | 7 | cidades_bairros | enderecamentos_cidades_e_bairros |
| 121 | CEPs | 8 | ceps | enderecamentos_ceps |
| 122 | Ruas | 9 | ruas | enderecamentos_ruas |
| 123 | Nomes de bairros | 10 | bairros | enderecamentos_nomes_de_bairros |
| 124 | Nomes de logradouros | 11 | logradouros | enderecamentos_nomes_de_logradouros |
| 201 | Mapas | 87 | mapas | enderecamentos_mapas |
🗂️ Tabelas do Sistema
🌎 Níveis Superiores
pais- Paísesregioes- Regiõesuf- Estados (UF)uf_mesorregioes- Mesorregiõesuf_microrregioes- Microrregiões
🏙️ Níveis Locais
cidades- Municípiosbairros- Nomes de bairroscidades_bairros- Relacionamentoceps- Códigos postaisruas- Ruas vinculadaslogradouros- Nomes de logradourosmapas- Visualização geográfica
🔗 Integrações com a Plataforma
👥
App 0004 - Participantes
Endereços de clientes, fornecedores e transportadoras
🚚
App 0044 - Rotas
Planejamento de entregas por endereço
📄
App 0012 - NF-e
Dados fiscais do destinatário
📊
App 0028 - Faturamento
Análise por região, UF, cidade
🗺️
App 0044 - Rotas IA
Traçado de rotas com Google Maps
📍
App 0052 - Motoristas
Endereços de partida e destino
🏆 Propriedade Intelectual
Marca Registrada
OndeVou.com®
Propriedade Intelectual Assegurada
Processo INPI:
908765967
Titular:
ONDEVOU TECNOLOGIA LTDA
ONDEVOU TECNOLOGIA LTDA
CNPJ:
17.058.605/0001-36
Classificação:
Classe 42 - Serviços de TI
Classe 42 - Serviços de TI
🏆
10+
anos de proteção