Central de Ajuda Quaza Provedores

Mapa de Rede — Visualização geográfica de clientes e fibra (PT)

Mapa de Rede — Visualização geográfica de clientes e fibra — Quaza

O Mapa de Rede mostra, sobre um mapa de verdade, onde estão os seus clientes e toda a sua estrutura de fibra: as caixas de atendimento (CTOs), os cabos de fibra óptica, os postes, as caixas de emenda e os POPs. Cada cliente vira um ponto no mapa, com a cor indicando se ele está conectado, e a partir desse mesmo ponto você abre a ficha do cliente, a ONU ou o usuário do contrato.

Esta wiki cobre o Mapa de Rede de ponta a ponta: o que cada camada mostra, como filtrar e achar um cliente, como consultar a viabilidade de fibra de um endereço junto ao seu integrador de mapa e reservar uma porta, e as telas de apoio (Ajusta Bairro, Integrador e Reserva de portas). Audiência: operadores de campo, técnicos de rede e equipe comercial do provedor.

Resumo de uma linha: abra Mapa de Rede para ver clientes e fibra no mapa; use Consultar viabilidade (na ficha do cliente, do contrato ou na oportunidade de venda) para descobrir se há fibra disponível num endereço e reservar a porta na caixa mais próxima.

Nesta wiki:

Quando usar o Mapa de Rede (e quando NÃO)

O Mapa de Rede é a visão geográfica do provedor. Use a tabela para confirmar em segundos se é o caminho certo:

Necessidade	Caminho
Ver onde estão os clientes no mapa e quem está conectado ou caído	Mapa de Rede (este documento) — camada Clientes
Ver a planta de fibra: caixas (CTOs), cabos, postes, caixas de emenda e POPs	Mapa de Rede — ligar as camadas de fibra
Saber se um endereço tem fibra disponível e reservar uma porta	Consultar viabilidade (ver seção ) — exige integrador de mapa ativo
Cadastrar o cliente, plano, valor e o acesso dele	Cliente e Contrato
Gerenciar a fibra (ONUs, OLTs, caixas, sinais) em listas e cadastros	Fibra
Acompanhar uma venda em andamento e a viabilidade do endereço da proposta	CRM (oportunidade de venda)

Não é um cadastro. O Mapa de Rede mostra dados que já existem em outras telas. Um cliente só aparece como ponto se a ficha dele tiver latitude e longitude preenchidas e o contrato estiver ativo. Cliente sem coordenadas não aparece no mapa, mesmo existindo no sistema.

Glossário

Termo	O que é
Camada	Cada tipo de informação que pode ser ligado ou desligado no mapa: Clientes, Caixas CTO, Caixas de Emenda, Postes, POP e Cabos FO. Você marca o que quer ver.
CTO (Caixa de atendimento)	A caixa de fibra na rua de onde saem as conexões dos clientes próximos. Tem uma quantidade limitada de portas.
Porta	Cada saída de uma CTO onde se conecta um cliente. Quando todas as portas estão ocupadas, a caixa está lotada e não atende novos clientes naquele ponto.
ONU	O equipamento de fibra instalado na casa/empresa do cliente. É ele que reporta o sinal e indica se o cliente está conectado.
POP (Ponto de presença)	O ponto central da rede — normalmente a sede ou um data center de onde a fibra se ramifica.
Caixa de emenda (CE)	Caixa onde cabos de fibra são emendados ao longo do percurso, sem atender cliente diretamente.
Cabo FO	O traçado do cabo de fibra óptica desenhado no mapa, ligando POPs, caixas de emenda e CTOs.
Viabilidade	A consulta que verifica se existe fibra disponível para atender um endereço — ou seja, se há uma caixa próxima com porta livre.
Integrador de mapa	O sistema externo de gestão de rede de fibra que o provedor usa (OzMap ou GeoGrid). É de onde o Quaza puxa a viabilidade e onde reserva as portas.
Sinal	A medida de qualidade da conexão de fibra do cliente, lida pela ONU. No mapa pode ser filtrado em faixas: Ótimo, Bom, Regular, Neutro e Ruim.

Antes de começar

Módulo Mapa de Rede liberado

O Mapa de Rede é um módulo opcional. Se o item de menu não aparecer para você, ele ainda não foi liberado para a sua empresa — solicite a liberação ao suporte da Quaza. O grupo de menu Mapa de Rede reúne todas as telas desta wiki.

Clientes com endereço localizado

Um cliente só vira ponto no mapa se a ficha dele tiver coordenadas (latitude/longitude). Elas costumam ser preenchidas a partir do endereço cadastrado. Se muita gente não aparece, revise os endereços e use o Ajusta Bairro para corrigir bairros em massa.

Integrador de mapa ativo (só para viabilidade)

Ver clientes e a planta de fibra no mapa não exige integrador. Já a consulta de viabilidade e a reserva de porta só funcionam com um integrador de mapa cadastrado e ativo. Cadastro em:

Menu → Mapa de Rede → Integrador

A tela do Mapa de Rede

Acesse o mapa pelo menu lateral:

Menu → Mapa de Rede → Mapa de Rede

A tela abre com um mapa em tela cheia e um painel à esquerda. Na barra de ícones à esquerda do painel você alterna entre dois modos: Camadas (o que aparece no mapa) e Filtros e Pesquisa (achar e filtrar clientes). Há ainda a ferramenta de medição de distância e o botão de mapa de concentração.

Tela do Mapa de Rede com o painel de camadas aberto

O mapa abre no mundo todo? Quando você ainda não tem clientes nem POP com coordenadas, o mapa abre afastado, como na imagem acima. Assim que houver cidades, POP ou clientes localizados, ele se centraliza na sua região. Você também pode usar o filtro por cidade para ir direto ao ponto.

Camadas — o que aparece no mapa

No painel Camadas você liga e desliga cada tipo de informação. O mapa lembra o que você deixou marcado:

Camada	O que mostra
Clientes	Um ponto por cliente localizado. A cor indica conexão (verde = sessão conectada, vermelho = sem conexão). O desenho do ponto muda conforme o tipo de cliente (residência, empresa, condomínio) e, quando há ONU de fibra, vira um ícone de roteador.
Caixas CTO	As caixas de atendimento de fibra. Ao expandir essa camada, você escolhe quais tipos de caixa exibir.
Caixas de Emenda	As caixas de emenda do trajeto de fibra.
Postes	Os postes cadastrados no traçado da rede.
POP	Os pontos de presença (centros da rede).
Cabos FO	O traçado dos cabos de fibra óptica ligando os elementos.

Quando há muitos clientes próximos, o mapa agrupa os pontos em um círculo com a quantidade. A cor do grupo resume o estado: verde quando todos estão conectados, vermelho quando todos estão caídos e amarelo quando há de tudo. Ao aproximar o zoom, o grupo se abre nos pontos individuais.

O que aparece ao clicar num cliente

Clicar em um ponto de cliente abre um balão com nome, documento, sinal (quando há ONU), cidade e bairro, mais botões de atalho: Abrir Cliente, Abrir ONU (quando há fibra) e Abrir Usuário. Eles abrem a tela correspondente em uma nova aba — é o caminho rápido do mapa para a ficha.

Filtros e pesquisa de clientes

Troque para o modo Filtros e Pesquisa (ícone de funil, à esquerda) para listar e localizar clientes. O seletor Filtrar lista oferece estas opções:

Filtro	Como usa
Filtrar por nome	Digite parte do nome do cliente; a lista e o mapa mostram só quem combina.
Filtrar por cidade	Escolha a cidade para ver apenas os clientes dela.
Filtrar por bairro	Escolha a cidade e depois um ou mais bairros (seleção múltipla).
Filtrar por ID de Clientes	Informe o código do cliente para ir direto a ele.
Filtrar por sinal	Filtre por faixa de qualidade do sinal de fibra: Ótimo, Bom, Regular, Neutro ou Ruim.

Abaixo do filtro fica a Relação de Clientes com a contagem. Clicar em um nome dá zoom e abre o balão daquele cliente no mapa. O contador Resultado do Filtro mostra quantos clientes restaram após o filtro.

Cliente sumiu do mapa? Confira se a camada Clientes está marcada, se nenhum filtro está ativo (use o × de limpar) e se o cliente tem endereço localizado. O filtro por sinal só destaca quem tem ONU com leitura de sinal.

Consultar viabilidade e reservar porta

A consulta de viabilidade responde à pergunta comercial mais comum: "consigo atender este endereço com fibra?". Ela pergunta ao seu integrador de mapa quais caixas existem num raio em volta de um ponto e quais têm porta livre — e permite reservar uma porta ali mesmo.

O botão Consultar viabilidade aparece em três lugares, sempre ligado ao endereço daquele cadastro:

Na ficha do Cliente ;
Na ficha do Contrato ;
Na oportunidade de venda do CRM .

Passo a passo

#	Passo
1	No cadastro (cliente, contrato ou oportunidade), clique em Consultar viabilidade. Abre uma janela com um mapa centrado no endereço.
2	Confira ou ajuste o ponto: informe Latitude e Longitude, ou digite o Endereço e use Buscar por endereço para o sistema localizar no mapa. Você também pode arrastar/clicar no mapa para reposicionar.
3	Defina o Raio (m) da busca (o quanto em volta do ponto você quer procurar caixas).
4	Clique em Avançar. O Quaza consulta o integrador e lista as caixas encontradas, com Descrição, Identificador, Distância, Latitude e Longitude.
5	Use o ícone de "olho" de uma caixa para ver as portas dela e quais estão disponíveis.
6	Escolha uma porta livre e confirme a reserva. O Quaza registra a reserva no integrador e cria a reserva na tela Reserva de portas . Use Voltar para refazer a busca ou Cancelar para fechar.

Se não houver fibra no local, o integrador responde que não há viabilidade e a janela avisa. Isso é resposta normal: significa que aquele endereço não tem caixa com porta livre dentro do raio pesquisado. Tente aumentar o raio ou conferir o ponto.

A viabilidade vem do integrador, não do Quaza. O resultado depende de como a sua rede está cadastrada no OzMap ou GeoGrid. Caixa cheia, porta marcada como ocupada ou caixa fora do raio resultam em "sem viabilidade" mesmo que fisicamente exista fibra perto.

Reserva de portas — situações

Cada porta reservada pela consulta de viabilidade vira um registro na tela de Reserva de portas:

Menu → Mapa de Rede → Reserva de portas

A reserva passa por três situações, com a linha colorida na lista:

Situação	O que significa	Próxima ação
Reservada	A porta foi reservada no integrador, mas o cliente ainda não está ativo nela.	Use Ativar reserva quando o cliente for de fato conectado, ou Cancelar reserva para liberar a porta.
Ativa	A porta está em uso pelo cliente — a ativação foi confirmada no integrador.	Nenhuma; a porta está ocupada.
Cancelada	A reserva foi desfeita e a porta liberada no integrador.	Nenhuma; é só histórico.

Os botões Ativar reserva e Cancelar reserva ficam na própria linha da listagem e pedem confirmação antes de mexer no integrador.

Ativar e cancelar reserva mexem no integrador de verdade. Confirmar uma dessas ações altera o estado da porta no OzMap/GeoGrid. Só ative quando o cliente realmente vai usar aquela porta; só cancele quando quiser liberá-la para outro atendimento.

Integrador de mapa

O integrador é a conexão entre o Quaza e o seu sistema de gestão de rede de fibra. É ele que responde às consultas de viabilidade e recebe as reservas de porta. Cadastro em:

Menu → Mapa de Rede → Integrador

Ao adicionar, escolha o Gateway (o tipo de sistema): OzMap ou GeoGrid. Conforme o gateway, a tela pede as credenciais de acesso — token de API e, no GeoGrid, a instância. Há também um botão Testar conexão API para conferir se as credenciais estão corretas antes de usar.

Só um integrador ativo por vez. O sistema não deixa ter dois integradores ativos simultaneamente. Para trocar de sistema, desative o atual antes de ativar o novo.

As credenciais são sensíveis. O token e a senha de API dão acesso à sua rede no sistema externo. Trate-os como senha: não compartilhe e troque se houver suspeita de vazamento.

Ajusta Bairro

Endereços com o bairro escrito de formas diferentes (ou em branco) atrapalham o filtro por bairro no mapa. O Ajusta Bairro é a ferramenta para corrigir esses bairros em massa, por cidade.

Menu → Mapa de Rede → Ajusta Bairro

Selecione a cidade, opcionalmente informe parte do nome do bairro (vírgula separa vários termos) e clique em Buscar. A ferramenta traz os endereços para você padronizar o nome do bairro de uma vez.

Pegadinhas frequentes

Cliente não aparece no mapa. O ponto só surge se a ficha tiver latitude e longitude e o contrato estiver ativo. Cliente sem coordenadas fica invisível no mapa, mesmo cadastrado.

"Nenhum integrador de mapas disponível". A consulta de viabilidade e a reserva de porta exigem um integrador ativo. Sem isso, o botão Consultar viabilidade dá esse aviso. Cadastre/ative em Mapa de Rede → Integrador.

Cor do ponto = conexão, não pagamento. Verde significa que a sessão está conectada; vermelho, sem conexão no momento. Não confunda com situação financeira ou bloqueio — para isso, abra a ficha do cliente.

Filtro por sinal só pega quem tem ONU. A faixa de sinal (Ótimo, Bom, Regular...) vem da leitura da ONU de fibra. Cliente sem ONU ou sem leitura recente não entra nesse filtro.

"Sem viabilidade" pode ser raio pequeno. Se o integrador não achar caixa, aumente o raio da busca antes de concluir que o endereço não tem fibra. Caixas além do raio simplesmente não são consideradas.

O painel do mapa fica em português. Os rótulos do painel de camadas (Caixas CTO, Caixas de Emenda, Postes, Cabos FO) aparecem em português mesmo no sistema em espanhol — é uma limitação atual do mapa.

Ativar/Cancelar reserva é definitivo no integrador. Essas ações alteram a porta no sistema externo. Cancele apenas se quiser realmente liberar a porta; ative apenas quando o cliente for usar.

Bairro bagunçado quebra o filtro. Se "filtrar por bairro" não mostra o que devia, normalmente é porque o mesmo bairro está escrito de formas diferentes. Padronize com o Ajusta Bairro .

O agrupamento esconde pontos próximos. Quando muitos clientes estão no mesmo prédio/quarteirão, eles aparecem como um número (cluster). Aproxime o zoom ou clique no grupo para abri-lo nos pontos individuais.

Só um integrador ativo. Tentar ativar um segundo integrador dá erro. Desative o anterior primeiro.

Perguntas frequentes

Por que meu cliente não aparece no mapa?

Porque a ficha dele não tem latitude/longitude, ou o contrato não está ativo. O mapa só plota clientes localizados de contratos ativos. Confira o endereço do cliente e, se preciso, padronize o bairro no Ajusta Bairro.

O que a cor verde e vermelha dos pontos significa?

Verde indica que a sessão do cliente está conectada agora; vermelho indica que não há conexão no momento. É o estado da conexão, não o estado financeiro nem bloqueio.

Preciso de integrador de mapa para usar o Mapa de Rede?

Não para ver clientes e a planta de fibra. O integrador só é exigido para a consulta de viabilidade e a reserva de portas, que conversam com um sistema externo (OzMap ou GeoGrid).

De onde vem o resultado da consulta de viabilidade?

Do integrador de mapa ativo. O Quaza envia o ponto e o raio, e o OzMap ou GeoGrid responde quais caixas existem por perto e quais têm porta livre. Por isso a resposta depende de como a rede está cadastrada lá.

Consultei viabilidade e deu "sem viabilidade". O que fazer?

Significa que não há caixa com porta livre dentro do raio pesquisado. Aumente o raio, confira se o ponto está no endereço certo e verifique no integrador se a caixa próxima tem portas disponíveis.

Qual a diferença entre reservar e ativar uma porta?

Reservar guarda a porta para aquele cliente (situação Reservada). Ativar confirma que o cliente está usando a porta (situação Ativa). Cancelar libera a porta. Ativar e cancelar mexem no integrador de verdade.

Onde vejo as portas que já reservei?

Em Mapa de Rede → Reserva de portas. A lista mostra cliente, conexão, caixa, porta e situação (Reservada, Ativa ou Cancelada), com botões para ativar ou cancelar cada reserva.

Posso ter OzMap e GeoGrid ao mesmo tempo?

Cadastrar, sim; ativos ao mesmo tempo, não. O sistema permite apenas um integrador ativo por vez. Para trocar, desative um e ative o outro.

Como abro a ficha do cliente direto do mapa?

Clique no ponto do cliente. No balão que abre, use Abrir Cliente, Abrir ONU (se tiver fibra) ou Abrir Usuário — cada um abre a tela em nova aba.

O filtro por bairro não traz o bairro certo. Por quê?

Quase sempre é grafia divergente do mesmo bairro nos endereços. Use o Ajusta Bairro para padronizar o nome do bairro por cidade e o filtro volta a funcionar.

O que é o "mapa de concentração"?

É uma visualização que destaca as regiões com maior concentração de clientes, ajudando a enxergar onde a base está mais densa. Fica disponível quando não há filtro de pesquisa ativo.

Não vejo o menu Mapa de Rede. E agora?

O Mapa de Rede é um módulo opcional. Se o item não aparece, ele ainda não foi liberado para a sua empresa — solicite ao suporte da Quaza.

Documentos relacionados

Fibra — gerencie ONUs, OLTs, caixas de atendimento e sinais em listas e cadastros (a base do que aparece no mapa).
Cliente — cadastro e endereço do cliente, de onde saem as coordenadas que o posicionam no mapa.
Contrato — plano, acesso e a consulta de viabilidade a partir do endereço do contrato.
CRM — oportunidades de venda, com consulta de viabilidade do endereço da proposta.