Pontos de Interesse - Importação de Pontos de Interesse

Descrição da Interface

O módulo Importação de Pontos de Interesse é parte do sistema de gerenciamento de frota "CONCEPT RASTREAMENTO" e permite aos usuários importar pontos de interesse geográficos a partir de diferentes formatos de arquivo. A tela apresenta um layout organizado em etapas numeradas, guiando o usuário pelo processo de importação de forma sequencial e clara.

A interface está estruturada como um cartão com o título "Importação de Pontos de Interesse por Arquivo" no topo. O processo de importação é dividido em quatro etapas principais, cada uma claramente identificada por números e títulos. Para acessar clique  no menu FROTAS, seção PONTOS DE INTERESSE e opção IMPORTAÇÃO DE PONTOS DE INTERESSE.

Elementos da Interface

Etapa 1: Informe os parâmetros abaixo

• Seleção de Grupo: Campo de seleção dropdown que permite escolher um grupo de pontos de interesse
• Identificar?: Caixa de seleção (checkbox) que permite definir se os pontos devem ser identificados
• Enviar Alerta?: Caixa de seleção para definir se alertas devem ser enviados para estes pontos
• Início/Fim Rota?: Caixa de seleção para marcar se os pontos representam início ou fim de rota
• Atualizar duplicados?: Caixa de seleção (pré-selecionada) para definir se pontos com códigos duplicados devem ser atualizados

Etapa 2: Informe os parâmetros abaixo

• Tipo de Arquivo: Campo de seleção dropdown com as seguintes opções:
  • KML Ponto
  • KML Polígono
  • CSV
  • CSV Control
  • TXT Control
• Avisos Informativos: Caixas com fundo laranja que exibem informações relevantes baseadas no tipo de arquivo selecionado:
  • Para CSV: Informa sobre o formato esperado (separador ponto e vírgula) e a ordem das colunas
  • Para KML Ponto/Polígono: Aviso sobre interrupção da importação caso existam códigos duplicados
  • Para CSV/CSV Control/TXT Control: Aviso sobre atualização de latitude e longitude para pontos com códigos duplicados

Etapa 3: Selecione o formato do arquivo

• Raio (metros): Campo numérico para definir o raio do ponto de interesse (visível apenas quando o tipo não é polígono)
• Tempo de Permanência: Campo numérico para definir o tempo mínimo de permanência no ponto
• Limite de Velocidade: Campo numérico para definir a velocidade máxima permitida no ponto

Etapa 4: Selecione o arquivo a ser importado

• Botão Selecionar: Permite escolher o arquivo a ser importado
• Campo de exibição do nome do arquivo: Mostra o nome do arquivo selecionado
• Botão Upload: Ícone para enviar o arquivo (ativo apenas quando um arquivo é selecionado)

Etapa 5: Resultado (visível apenas após o upload)

• Área de resultado: Exibe as mensagens de sucesso ou erro do processo de importação em formato de texto

Propósito e Fluxo de Trabalho

Esta interface tem como propósito permitir a importação de pontos de interesse geográficos para o sistema de gerenciamento de frota. Estes pontos podem ser utilizados para monitoramento de veículos, definição de rotas, controle de viagens e outros fins relacionados ao gerenciamento de frota.

O fluxo de trabalho segue uma sequência lógica:

1. O usuário seleciona um grupo para os pontos de interesse e configura parâmetros básicos (identificação, alertas, início/fim de rota)
2. O usuário escolhe o tipo de arquivo a ser importado (KML, CSV, etc.)
3. O usuário define parâmetros específicos como raio, tempo de permanência e limite de velocidade
4. O usuário seleciona e envia o arquivo
5. O sistema processa o arquivo e exibe o resultado da importação

Instruções Passo a Passo

Como Importar Pontos de Interesse

1. Configurar Parâmetros Iniciais:

   • Na seção "1. Informe os parâmetros abaixo", selecione o grupo desejado no dropdown
   • Marque as opções desejadas: Identificar, Enviar Alerta, Início/Fim Rota
   • A opção "Atualizar duplicados" está marcada por padrão; desmarque se necessário

2. Selecionar o Tipo de Arquivo:

   • Na seção "2. Informe os parâmetros abaixo", escolha o formato do arquivo a ser importado:
     • KML Ponto: para arquivos KML contendo pontos
     • KML Polígono: para arquivos KML contendo polígonos
     • CSV: para arquivos CSV no formato especificado
     • CSV Control: para arquivos CSV no formato Control
     • TXT Control: para arquivos TXT no formato Control
   • Leia as informações específicas exibidas para o tipo selecionado

3. Configurar Parâmetros Adicionais:

   • Na seção "3. Selecione o formato do arquivo", defina:
     • Raio em metros (não aplicável para KML Polígono)
     • Tempo de permanência mínimo em minutos
     • Limite de velocidade em km/h

4. Selecionar e Enviar o Arquivo:

   • Clique no botão "Selecionar" na seção "4. Selecione o arquivo a ser importado"
   • Localize e selecione o arquivo desejado (formatos aceitos: CSV, KML, TXT)
   • O nome do arquivo aparecerá no campo de texto
   • Clique no botão de upload (ícone verde) para enviar o arquivo

5. Verificar o Resultado:

   • Após o envio, será exibida a seção "5. Resultado"
   • Verifique as mensagens para confirmar o sucesso da importação ou identificar possíveis erros
   • Se for necessário fazer ajustes, corrija os parâmetros ou o arquivo e tente novamente

Regras de Negócio e Validações

Validações Gerais:

• O sistema só permite importação de arquivos nos formatos CSV, KML e TXT
• Para utilizar a funcionalidade, o usuário precisa ter permissão de gravação ou ser um usuário com acesso master

Processamento de CSV:

• O arquivo CSV deve usar separador de ponto e vírgula (;)
• A primeira linha é considerada como cabeçalho
• A sequência de colunas deve ser: CODIGO | NOME | DESCRICAO | LATITUDE | LONGITUDE | CODIGO VENDEDOR | CODIGO LOJA | CODIGO ZONA | HORARIO INICIAL | HORARIO FINAL | TEMPO ATENDIMENTO

Tratamento de Duplicados:

• Para arquivos KML Ponto/Polígono: a importação é interrompida caso existam pontos com códigos duplicados
• Para arquivos CSV/CSV Control/TXT Control: pontos com códigos duplicados terão sua latitude e longitude atualizadas se a opção "Atualizar duplicados" estiver marcada

Conversão de Unidades:

• O raio é inserido em metros, mas é convertido para quilômetros no processamento (dividido por 1000)

Validações para Exclusão de Pontos:

O sistema impede a exclusão de pontos de interesse que estejam sendo utilizados nas seguintes situações:

• Em Controle de Entradas/Saídas
• Em histórico de Controle de Entradas/Saídas
• Em Controle de Viagens
• Em histórico de Controle de Viagens
• Em Controle de Viagens agendado
• Em pedidos
• Em avisos gerados

Formato KML:

• Ao exportar para KML, o sistema estrutura os dados conforme padrões específicos
• Para pontos circulares, o sistema converte raio em km para coordenadas poligonais usando fórmulas de cálculo considerando a curvatura da Terra

Perguntas Frequentes

1. Quais formatos de arquivo são aceitos para importação?

A interface aceita arquivos nos formatos KML (para pontos ou polígonos), CSV (padrão ou formato Control) e TXT (formato Control).

2. Como devo formatar meu arquivo CSV para importação?

O arquivo CSV deve usar o separador ponto e vírgula (;). A primeira linha é considerada cabeçalho. As colunas devem seguir a ordem: CODIGO, NOME, DESCRICAO, LATITUDE, LONGITUDE, CODIGO VENDEDOR, CODIGO LOJA, CODIGO ZONA, HORARIO INICIAL, HORARIO FINAL, TEMPO ATENDIMENTO. Existe um arquivo modelo disponível para download.

3. O que acontece se meu arquivo tiver pontos com códigos duplicados?

Depende do formato do arquivo. Para KML (Ponto ou Polígono), a importação será interrompida. Para CSV, CSV Control ou TXT Control, os pontos duplicados terão sua latitude e longitude atualizadas se a opção "Atualizar duplicados" estiver marcada.

4. O que significa a opção "Identificar"?

Esta opção determina se os pontos de interesse importados devem ser identificados no sistema. Quando ativada, os pontos serão reconhecidos pelo sistema para fins de monitoramento.

5. Para que serve o campo "Raio" e quando devo utilizá-lo?

O campo Raio define a área circular ao redor do ponto central que será considerada como parte do ponto de interesse. É medido em metros e é aplicável para todos os tipos de importação exceto KML Polígono (que já define sua própria área).

6. O que representa o "Tempo de Permanência"?

Este campo define o tempo mínimo (em minutos) que um veículo deve permanecer dentro da área do ponto de interesse para que seja considerado como uma parada válida.

7. Como funciona a opção "Enviar Alerta"?

Quando esta opção está marcada, o sistema enviará alertas quando veículos entrarem ou saírem da área do ponto de interesse. Isso é útil para monitoramento em tempo real.

8. Posso editar os pontos de interesse após a importação?

Sim, após a importação os pontos estarão disponíveis no sistema e poderão ser editados individualmente ou em lote através de outras funcionalidades do sistema.

9. Existe alguma limitação na quantidade de pontos que posso importar?

O sistema não impõe um limite específico, mas importações muito grandes podem levar mais tempo para processar. Recomenda-se dividir importações extensas em lotes menores.

10. O que significa a opção "Início/Fim Rota"?

Esta opção marca os pontos importados como possíveis pontos de início ou fim de rota, o que é útil para planejamento de rotas e análise de trajetos no sistema.