Mapa — Mapa de Red + Georreferenciamiento
El módulo
Mapa da al proveedor una visión
geográfica de su red y clientes. Es donde se ve
dónde cada CTO, poste, cliente y cable de fibra están físicamente — sobre el mapa real (Google Maps / OpenStreetMap).
Diferente del módulo
Fibra y Red
(registros + monitoreo técnico), el Mapa
renderiza visualmente esos registros sobre un mapa, permitiendo planificar expansión, encontrar capacidad ociosa, e identificar problemas geográficamente.
Visión general — para qué sirve el mapa
O Mapa é a camada visual em cima dos cadastros de rede. Os mesmos dados do módulo Fibra y Red aparecem como ícones georreferenciados que você liga/desliga por camada.
CASOS DE USO TÍPICOS:
1. PLANIFICACIÓN DE EXPANSIÓN
¿Dónde hay CTO con capacidad ociosa? ¿A qué barrio expando?
→ activa capa Cajas CTO + filtro "puertos libres > 8"
2. ATENCIÓN AGENDADA
Técnico va a instalar 5 clientes mañana. ¿Cuál es la mejor ruta?
→ activa capa Clientes + filtra OS abiertas
3. DIAGNÓSTICO DE CAÍDA REGIONAL
"Barrio X sin internet" — ¿qué CTO/Splitter atiende? ¿Qué poste?
→ capa Postes + Cajas + filtra por barrio
4. AUDITORÍA DE COBERTURA
Cliente reclama "área no atendida" — ¿verdad?
→ mapa muestra CTOs más cercanas, calcula distancia
5. LOCALIZACIÓN DE CABLES
Cable de FO cortado en algún punto — ¿qué ruta?
→ capa Cables FO muestra trazado exacto
═══════════════════════════════════════════════════════════════════════
ARQUITECTURA DE CAPAS (LAYERS)
═══════════════════════════════════════════════════════════════════════
MAPA BASE (Google Maps / OpenStreetMap)
↓
┌─────────────────────────────────────────────────┐
│ CLIENTES ● (puntos rosa, con info popup) │
├─────────────────────────────────────────────────┤
│ CAJAS CTO ▣ (cajas de terminación óptica) │
├─────────────────────────────────────────────────┤
│ CAJAS DE EMPALME ◯ (fusiones en la ruta del cable) │
├─────────────────────────────────────────────────┤
│ POSTES ● (puntos negros numerados) │
├─────────────────────────────────────────────────┤
│ POP ▆ (Point of Presence — concentradores) │
├─────────────────────────────────────────────────┤
│ CABLES FO ━━━ (trazado de las fibras) │
└─────────────────────────────────────────────────┘
Cada capa puede activarse/desactivarse independientemente.
Glosario
| Término |
Significado |
| Capa / Layer |
Conjunto de puntos del mismo tipo (clientes, CTOs, postes) que se activa/desactiva en el mapa |
| CTO |
Caja de Terminación Óptica. Caja instalada en el poste/pared donde llegan las fibras de los clientes (8/16/32 puertos) |
| POP |
Point of Presence. Sitio físico donde reside el OLT (concentrador). Origen de la red óptica |
| Caja de Empalme |
Caja donde dos cables de fibra son fundidos (empalme óptico). No atiende cliente directo |
| Splitter |
Divisor óptico pasivo. 1 fibra entra, N salen (ej: 1:8, 1:16, 1:32) |
| Cable FO |
Cable de Fibra Óptica. Puede tener 6, 12, 24, 48, 144 fibras dentro |
| Drop |
Cable ligero que va de la CTO hasta la casa del cliente |
| Reserva de puerto |
Pre-reserva de un puerto CTO para cliente que va a ser instalado (evita conflicto) |
| Georreferencia |
Latitud + Longitud asociada a un punto (cliente, CTO, poste) |
| Barrio / Manzana |
Subdivisión geográfica usada para filtros y reportes |
| Integrador (Mapa) |
Puente con sistemas externos de geoinformación (autoCAD, QGIS, ipscore, etc.) |
1. Mapa de Rede
Camino: Mapa → Mapa de Red
Es la pantalla principal del módulo. Muestra un mapa interactivo con capas de elementos de la red y del registro de clientes.
Sidebar — Capas
| Capa |
Ícono |
Qué representa |
| Clientes |
● rosa |
Cada cliente en su dirección (lat/long del registro) |
| Cajas CTO |
▣ azul |
Cajas de Terminación Óptica (puntos de capilarización) |
| Cajas de Empalme |
◯ |
Puntos de fusión de cables |
| Postes |
● negro |
Postes propios o compartidos (ANDE, etc.) |
| POP |
▆ |
Sitios donde los OLTs están hospedados |
| Cables FO |
━━━ |
Trazado de las fibras (líneas conectando CTOs/POPs) |
Herramientas (sidebar izquierda)
| Ícono |
Función |
| 🗂 (Layers) |
Activa/desactiva capas (mostrado abierto en la imagen) |
| ▽ (Filtro) |
Filtra por barrio, plan, situación del cliente |
| 📏 (Regla) |
Mide distancia entre 2 puntos en el mapa (planificar drop) |
| 📦 (Otras capas) |
Capas adicionales (KMZ importado, áreas pintadas) |
Interacción
-
Hacer clic en ícono — abre popup con info del elemento (cliente: nombre, plan, OS abiertas; CTO: puertos libres/usados)
-
Zoom — botones +/- o rueda del mouse. En zoom alto ves detalles; bajo ves visión regional
-
Arrastrar — mover el mapa
-
Buscar cliente — la barra superior encuentra cliente y centra el mapa en él
Color de los íconos de cliente: puede variar por estado del contrato (verde=activo, rojo=bloqueado, amarillo=pre-registro). Permite ver visualmente qué región tiene más morosidad o pre-registros parados.
2. Ajusta Barrio
Camino: Mapa → Ajusta Barrio
Herramienta de limpieza de datos. Generalmente, al importar/registrar muchos clientes, el campo Barrio queda desalineado: "Centro", "centro", "CENTRO", "Cnt", "Barrio Centro" — todo lo mismo. Esta pantalla permite consolidar.
Cómo usar
-
1Buscar Ciudad
-
2Escribir variaciones del nombre del Barrio separadas por coma (ej: "Centro, centro, CENTRO, Cnt")
-
3Hacer clic en "Buscar" — el sistema muestra todos los clientes con esas variaciones
-
4Confirmar consolidación — todos pasan a un único nombre estandarizado
Por qué importa: reportes "clientes por barrio" solo funcionan si el registro está limpio. 50 variaciones de "Centro" se vuelven 50 líneas distintas en el gráfico. Tras Ajusta Barrio = 1 línea agregada.
3. Integrador de Mapa
Camino: Mapa → Integrador
Configuración de integración con sistemas externos de georreferenciamiento. Permite importar/exportar datos hacia/desde softwares de planificación (QGIS, autoCAD), proveedores de geocoder, sistemas de gestión de fibra (IPscore, etc.).
Tipos de integración
| Tipo |
Uso |
| KML/KMZ Import |
Importar trazado de cables dibujados en otro programa |
| Geocoder API |
Dirección → lat/long (Google Geocoder, Nominatim/OSM) |
| WMS / Tile server |
Mostrar imágenes raster (satélite, plano de ciudad) |
| Software de gestión FO |
Sincronizar con IPscore, FiberPlanIT, etc. |
Geocoder externo: al registrar cliente nuevo con dirección, Quaza puede consultar geocoder para obtener lat/long automáticamente — el cliente aparece en el mapa en el lugar correcto sin escritura manual. El Integrador define qué servicio usar.
4. Reserva de Puertos
Camino: Mapa → Reserva de Puertos
Lista de reservas pre-asignadas en CTOs para clientes en pre-registro. Evita que dos equipos intenten usar el mismo puerto.
Cómo funciona
| Paso |
Quién |
Acción |
| 1 |
Vendedor |
Captura cliente nuevo, ve en el mapa qué CTO atiende la región |
| 2 |
Vendedor |
Crea reserva de puerto — CTO X, puerto 5 quedan "Reservados" para ese cliente |
| 3 |
Quaza |
Mapa marca puerto como "ocupado (reserva)" — otros vendedores no lo usan |
| 4 |
Técnico |
Va a instalar — confirma puerto 5 reservado, activa, baja reserva |
| 5 |
Sistema |
Si la reserva expira sin instalación (ej: 30 días), libera el puerto |
Columnas
| Columna |
Qué muestra |
| Cliente |
Para quién está reservado |
| Conexión |
Tipo: FTTH, FTTB, EPON, GPON |
| Caja |
Qué CTO |
| Puerto |
Número del puerto (1-16 típicamente) |
| Situación |
Reservado / Confirmado / Cancelado / Expirado |
Reservas olvidadas: vendedor reserva pra cliente que não fechou contrato, esquece de cancelar. Puerto fica "ocupada" sem necessidade. Configure expiração automática (30 dias) e revise mensalmente as reservas com mais de N dias sem instalação.
Flujos típicos paso a paso
Flujo 1: Registrar cliente nuevo con georreferencia
| Paso |
Dónde |
Qué hacer |
| 1 |
Cliente → Agregar
|
Llenar CI/CPF, nombre, dirección completa |
| 2 |
Quaza (auto) |
Consulta geocoder configurado en Integrador — obtiene lat/long |
| 3 |
Mapa → Mapa de Red |
Activa capa Clientes — nuevo aparece en el mapa |
| 4 |
Vendedor verifica |
¿Punto está en el lugar correcto? Si no, edita lat/long manualmente |
| 5 |
Hace clic en la CTO más cercana |
Ve puertos libres + reserva uno para ese cliente |
Flujo 2: Diagnóstico de caída regional
| Paso |
Dónde |
Qué hacer |
| 1 |
Atención detecta patrón |
"Barrio Vila Nova sin internet hace 30min" |
| 2 |
Mapa → filtro por barrio = Vila Nova |
Muestra clientes + CTOs de la región |
| 3 |
Camada Cables FO |
Ver qué cable sirve esa región |
| 4 |
Camada Cajas de Empalme |
Identificar puntos de fusión entre OLT y CTO |
| 5 |
Técnico va al lugar |
Coordenadas exatas da Caja de Empalme mais provável |
Flujo 3: Planificar expansión a barrio nuevo
| Paso |
Dónde |
Qué hacer |
| 1 |
Mapa → Mapa de Red |
Centralizar barrio objetivo, activar capas CTOs + Postes |
| 2 |
Evaluar densidad |
Tem CTOs vazias na borda da área já coberta? Cable FO chega lá? |
| 3 |
Regla |
Medir distancia del POP al barrio nuevo (define metraje cable) |
| 4 |
Stock |
Calcular cuántos postes + cajas + km de cable son necesarios |
| 5 |
Presupuestar |
Planificación financiera del proyecto |
Flujo 4: Limpiar barrios desorganizados
| Paso |
Dónde |
Qué hacer |
| 1 |
Mapa → Ajusta Barrio |
Ciudad=Asunción |
| 2 |
Barrio |
"Vila Madalena, VILA MADALENA, vila madalena, vilamadalena, V Madalena" |
| 3 |
Buscar |
Muestra clientes con esas variaciones |
| 4 |
Confirmar consolidación |
Todos pasan a "Vila Madalena" |
| 5 |
Repetir para los otros barrios |
Iterar hasta base limpia |
| 6 |
Reportes |
Ahora "clientes por barrio" funciona correctamente |
Trampas frecuentes
1. Cliente queda "en el medio del océano" en el mapa
Lat/long inválida o cero. Causa: registro sin geocoder configurado, o cliente importado de CSV sin lat/long. Solución: editar cliente, hacer clic en "Buscar en el mapa" para que el geocoder actualice, o hacer clic manualmente en el mapa para setear coordenadas.
2. Mapa lento o se traba con muchos clientes
Proveedor con 50k+ clientes activos: renderizar todos los puntos al mismo tiempo es caro. Usa cluster (agrupamiento por proximidad) o filtra por barrio/región antes de habilitar la capa Clientes.
3. Cable FO desenhado errado — passa por dentro de prédio
Trazado manual dibujado sin cuidado. El mapa queda feo y el cálculo de metraje distorsionado. Usa herramienta KML externa (Google Earth) para dibujar bonito + importar vía Integrador.
4. CTO muestra llena pero tiene puertos libres
Sincronización entre registro de CTO (Red) y mapa rota. Fuerza actualización — botón "Recalcular ocupación" si está disponible, o edita un puerto para forzar refresh.
5. Reserva expirada no liberó
Cron de expiración de reservas (en
Admin → Tareas
) parado. Resultado: puertos marcados reservados hace meses, pareciendo llenos. Verifica tarea y ejecuta manualmente "Limpiar reservas expiradas" si es necesario.
6. Cliente en pre-registro no aparece en el mapa
La capa Clientes puede filtrar solo Activos por defecto. En Filtro → incluir "Pre-registro" para ver. Útil para planificación de instalación (saber dónde van a entrar en los próximos 30 días).
7. Mapa mundial en lugar del barrio
Sin punto inicial configurado, el mapa abre en todo el mundo. Configura POP principal con lat/long de la oficina — el mapa se centra ahí al cargar. O usa el filtro para mostrar solo la ciudad deseada.
Galería de pantallas
Maparede
Ajustabairro
Integrador
Reservaporta
Documentos relacionados
Profundiza en los temas conexos:
-
Cliente
— el registro proporciona lat/long que aparece como punto en el mapa
-
Fibra y Red
— CTOs, postes, cables FO registrados aquí aparecen como capas en el mapa
-
Soporte / OS
— OSs pueden ser visualizadas en el mapa para ruteo de técnico
-
Inventario
— equipamientos físicos (ONUs, cajas) localizados vía mapa
-
Administración
— Tarea "Limpiar reservas expiradas" + integrador (geocoder)
-
Paneles
— visión ejecutiva complementa la visión geográfica
FAQ
¿Tiene app móvil con mapa para técnico en campo?
O Puertol do Técnico
tiene visualización básica, pero la app dedicada es servicio adicional (whitelabel). Consulta Quaza Tecnologia.
¿Puedo exportar el mapa a PDF?
Funcionalidad nativa limitada. Usa captura de pantalla (Print Screen) o imprime por el navegador (Ctrl+P → guardar PDF). Para mapas grandes, es mejor usar QGIS/Google Earth importando KML de Quaza.
¿Quaza usa Google Maps u OpenStreetMap?
Configurable en el Integrador. Google es más bonito pero tiene costo (API key paga). OpenStreetMap es gratuito pero con menos detalles en algunas regiones. La mayoría de los proveedores empieza con OSM.
¿Cómo mostrar áreas de cobertura (polígonos)?
Importa KML/KMZ vía Integrador. Dibujas el polígono en Google Earth/QGIS, exportas KML, lo subes a Quaza. Aparece como capa adicional.
¿Puedo tener heatmap de morosidad por región?
Indirectamente. Filtra capa Clientes por situación=Bloqueado, ve la densidad visual. Heatmap coloreado es desarrollo bajo demanda — conversa con el equipo.
Cliente nuevo, sin coordenadas exactas — ¿cómo registrar?
Registra la dirección, deja que el geocoder encuentre aproximadamente, después abre el cliente en el mapa, haz clic en "Editar lat/long" y arrastra el punto a la posición correcta. O pide lat/long del router vía app de levantamiento.
¿El mapa necesita internet para funcionar?
Sí — los tiles del mapa vienen de la red (Google/OSM). Sin internet, el fondo queda en blanco pero los íconos aún aparecen. Para ambientes offline, considera descargar tiles localmente (configuración avanzada).