Criando e Gerenciando Zonas

Zonas são limites geográficos que controlam como os veículos operam em áreas específicas. Este guia abrangente cobre tudo o que você precisa saber sobre criar, editar e gerenciar zonas no seu painel Levy Fleets.

O Que São Zonas?

Zonas no Levy Fleets são polígonos GeoJSON que definem limites geográficos com regras específicas. Essas zonas permitem recursos poderosos de controle de frota:

• Validação de término de viagem - Controlando onde os clientes podem encerrar suas viagens
• Aplicação de velocidade - Limitando automaticamente a velocidade do veículo em áreas designadas
• Controle de acesso - Impedindo que veículos operem em áreas restritas
• Incentivos - Encorajando clientes a estacionar em locais preferidos
• Gerenciamento de serviço - Definindo limites operacionais para sua frota

Acessando a Página de Zonas

1. Faça login no seu painel Levy Fleets
2. Navegue até Zonas na barra lateral esquerda
3. Se você gerencia múltiplas subcontas, certifique-se de que a subconta correta está selecionada no seletor de subcontas

A página de zonas exibe um mapa interativo com todas as suas zonas configuradas, junto com um painel para criar e gerenciar zonas.

Entendendo os Tipos de Zonas

O Levy Fleets suporta sete tipos de zonas, cada uma com comportamentos e casos de uso específicos:

Zona de Estacionamento (Verde)

Propósito: Designa áreas aprovadas onde os clientes podem encerrar suas viagens.

Usos Comuns:

• Áreas de estacionamento designadas próximas a comércios
• Estacionamentos públicos
• Terminais de transporte
• Zonas de estacionamento em calçadas aprovadas pela cidade

Zona de Estacionamento Proibido (Vermelha)

Propósito: Bloqueia o término de viagens mesmo se o local estiver dentro de uma zona de estacionamento.

Usos Comuns:

• Hidrantes e áreas de acesso de emergência
• Zonas de construção
• Propriedade privada
• Docas de carga
• Restrições temporárias de eventos

Zona Proibida (Vermelha, com aplicação)

Propósito: Restringe completamente a operação do veículo dentro do limite.

Usos Comuns:

• Propriedade privada onde veículos não são permitidos
• Canteiros de obras
• Praças exclusivas para pedestres
• Áreas com restrições temporárias (festivais, eventos)

Zona de Limite de Velocidade (Amarela)

Propósito: Limita automaticamente a velocidade do veículo dentro do limite.

Usos Comuns:

• Áreas com muito movimento de pedestres (centro, parques)
• Zonas escolares
• Áreas de hospitais e instalações médicas
• Bairros residenciais
• Áreas com limites de velocidade exigidos por regulamentações locais

Zona de Carregamento (Azul)

Propósito: Marca locais de depósitos ou estações de carregamento.

Usos Comuns:

• Estações e docas de carregamento
• Áreas de armazenamento de frota
• Depósitos de manutenção
• Locais de estação de troca

Zona de Bônus (Roxa/Índigo)

Propósito: Destaca áreas de retirada/entrega incentivadas para gamificação.

Opções de Configuração:

• Pontos de Recompensa: Pontos concedidos por encerrar nesta zona (ex.: 50 pontos)
• Multiplicador: Multiplicador de pontos de fidelidade (ex.: 1,5x)
• Zona Preferencial: Alternância para marcar como local de estacionamento preferencial

Usos Comuns:

• Zonas de incentivo de rebalanceamento
• Locais de retirada de alta demanda
• Áreas onde você quer incentivar o estacionamento
• Zonas promocionais durante eventos

Área de Serviço (Ciano/Azul Claro)

Propósito: Define o limite operacional geral para sua frota.

Criando uma Nova Zona

Dicas de Desenho

• Use visão de satélite para precisão (alterne nos controles do mapa)
• Amplie para posicionamento preciso dos limites
• Mantenha polígonos simples - formas complexas aumentam o tempo de processamento
• Alinhe com recursos - alinhe os limites da zona com contornos de edifícios e bordas de ruas para reduzir problemas de deriva do GPS

Editando Zonas Existentes

Visualizando Zonas

A seção "Zonas Existentes" mostra todas as zonas da sua subconta:

• Clique em uma linha de zona para isolá-la no mapa (oculta outras zonas temporariamente)
• Clique em "Mostrar Todas as Zonas" para exibir todas as zonas novamente
• As zonas são codificadas por cores por tipo para fácil identificação

Editando uma Zona

1. Clique no ícone de lápis/editar em uma linha de zona na lista de Zonas Existentes
2. O painel do editor de zonas aparece com as configurações atuais
3. Modifique o nome da zona, tipo, limite de velocidade ou outras configurações
4. Para redesenhar o limite da zona:
   • Clique em "Limpar" para remover o polígono atual
   • Desenhe um novo polígono usando as ferramentas de desenho
5. Clique em "Atualizar Zona" para salvar as alterações

Excluindo Zonas

1. Clique no ícone de lixeira/excluir em uma linha de zona
2. Confirme a exclusão na caixa de diálogo
3. A zona é excluída suavemente (marcada com um timestamp)

O que acontece quando você exclui uma zona:

• A zona é imediatamente excluída de todas as validações de viagem
• Veículos atualmente em uma zona de velocidade/proibida excluída terão as restrições removidas na próxima atualização de telemetria
• Eventos históricos de zona permanecem no banco de dados para fins de auditoria
• A zona pode ser restaurada por um administrador de banco de dados se necessário

Personalizando Cores das Zonas

As cores das zonas podem ser personalizadas por subconta para combinar com sua marca ou melhorar a visibilidade.

Acessando as Configurações de Cores

1. Vá para Painel -> Configurações
2. Role até a seção Cores das Zonas
3. Modifique os valores de cores hex para cada tipo de zona

Cores Padrão

Importando Zonas de GeoJSON

Para criação de zonas em massa, o Levy Fleets fornece uma capacidade de importação GeoJSON.

Formato do Arquivo GeoJSON

Cada arquivo deve:

• Ser nomeado após a subconta (ex.: Centro_Sao_Paulo_SP.geojson)
• Conter uma FeatureCollection com recursos Polygon
• Usar formato de coordenadas GeoJSON padrão [longitude, latitude]

Estrutura de Exemplo:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "badges": {
          "EN": "Estacionamento Rua Principal"
        }
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[lng, lat], [lng, lat], ...]]
      }
    }
  ]
}

Comportamento de Importação

• Mapeia nomes de arquivos para nomes de subcontas automaticamente
• Pula subcontas que já têm zonas de estacionamento
• Cria zonas com tipo parking por padrão
• Usa a propriedade badges.EN para nomes de zonas

Melhores Práticas

Convenções de Nomenclatura

Use nomenclatura consistente que inclua:

• Local (ex.: "Centro", "Rua Principal", "Parque da Cidade")
• Indicador de tipo (ex.: "Estacionamento", "Zona Lenta", "Zona Proibida")
• Identificador se existirem múltiplas zonas similares (ex.: "P1", "P2", "Norte", "Sul")

Exemplos:

• "Estacionamento Centro - Rua Principal"
• "Doca de Carga Prefeitura Estacionamento Proibido"
• "Praça de Pedestres Zona Lenta 15kph"
• "Propriedade Privada Zona Proibida - Rua Carvalho 123"

Recomendações de Design de Zonas

1. Mantenha polígonos simples - Formas complexas com muitos vértices aumentam o uso de CPU móvel e tempo de processamento de telemetria

2. Use visão de satélite - Alinhe os limites da zona com contornos de edifícios e bordas de ruas para minimizar reclamações de deriva do GPS

3. Considere a precisão do GPS - Deixe um pequeno buffer (5-10 metros) em torno de limites críticos, já que o GPS pode ter variações de precisão de 5-10 metros

4. Evite sobreposição desnecessária de zonas de velocidade - Quando as zonas se sobrepõem, o sistema escolhe o limite mais baixo, o que pode não ser intencional

5. Considere o tempo de aplicação - Zonas proibidas têm histerese de 15 segundos; zonas muito pequenas podem não acionar consistentemente

Testando Zonas

Antes de implantar zonas críticas:

1. Crie zona com veículo de teste
2. Passe pelo limite da zona várias vezes
3. Verifique a redução de velocidade no veículo
4. Verifique eventos de zona no histórico de viagens
5. Teste saída e restauração de velocidade
6. Confirme que as notificações para clientes funcionam

Permissões de Função

O gerenciamento de zonas requer funções de usuário específicas:

Usuários com funções inferiores veem uma visualização somente leitura das zonas no mapa.

Acesso à API de Parceiros

Parceiros podem acessar dados de zonas via API de Parceiros para integração com sistemas externos.

Endpoint

GET /api/partner/v1/zones

Parâmetros de Consulta

Autenticação

Requer uma chave de API de Parceiro no cabeçalho X-Partner-Api-Key.

Limites de Taxa

• 60 requisições por minuto
• 1.000 requisições por hora
• 10.000 requisições por dia

Solução de Problemas

Mapa Não Carregando

Sintomas: Área em branco onde o mapa deveria estar, ou mensagem "Carregando mapa..." persiste

Soluções:

1. Verifique se a chave da API do Google Maps está configurada corretamente
2. Verifique se a chave da API tem a API Maps JavaScript habilitada no Console do Google Cloud
3. Verifique se o faturamento está ativo no projeto do Google Cloud
4. Limpe o cache do navegador e atualize

Zona Não Aparecendo no Aplicativo do Cliente

Sintomas: Zona criada, mas clientes não a veem

Soluções:

1. Certifique-se de que a zona está salva (verifique a lista de Zonas Existentes)
2. Verifique se a subconta correta está selecionada
3. O aplicativo do cliente pode ter cache de zonas - aguarde alguns minutos ou peça ao cliente para atualizar
4. Verifique se o tipo de zona é um que aparece nos mapas do cliente (estacionamento, estacionamento proibido, limite de velocidade)

Ferramenta de Desenho Não Funcionando

Sintomas: Não consegue desenhar polígonos, clicar não tem efeito

Soluções:

1. Certifique-se de que você clicou na ferramenta de polígono (ícone de pentágono) primeiro
2. Verifique se nenhum polígono existente está sendo editado (clique em Limpar se necessário)
3. Tente atualizar a página
4. Verifique se você tem permissões suficientes (Gerente de Frota ou superior)

Zona Não Aplicando

Sintomas: Zona de limite de velocidade ou zona proibida não afetando veículos

Soluções:

1. Verifique se o tipo de zona está correto (speed_limit ou no_go)
2. Verifique se o polígono da zona cobre com precisão a área pretendida
3. Para zonas de velocidade, verifique se o valor speed_limit_kph está definido
4. Confirme que os veículos têm dispositivos IoT com protocolos suportados (Segway, OKAI, Omni, Queclink, Zimo)
5. Verifique se a configuração IoT está configurada corretamente em Configurações
6. Revise os logs do servidor para erros de aplicação de zona

Término de Viagem Rejeitado Quando Não Deveria

Sintomas: Clientes recebendo erro "não está em zona de estacionamento" em locais válidos

Soluções:

1. Verifique zonas de estacionamento proibido sobrepostas que podem estar bloqueando
2. Verifique o modo de validação de zona de estacionamento em Configurações
3. Certifique-se de que o polígono da zona de estacionamento realmente cobre o local (deriva do GPS pode posicionar o veículo fora)
4. Considere expandir ligeiramente os limites da zona de estacionamento para considerar a precisão do GPS

O Que Vem a Seguir?

• Como as Zonas Funcionam - Detalhes técnicos sobre avaliação e aplicação de zonas
• Zonas de Limite de Velocidade - Mergulho profundo na configuração de zonas de velocidade
• Guia de Início Rápido - Passo a passo completo de configuração