QT_METROSRAIO — Raio de Permanência (Metros)

Tela de configuração: ADM010 — Parâmetros do Sistema Localização: Aba Roteirização → grupo Cálculo Permanência Tabela: PARMSISTEMA.QT_METROSRAIO Tipo: DOM_INTEGER (inteiro) Valor padrão: 30

Descrição

Define a distância em metros do raio de proximidade utilizado para determinar se o vendedor/representante está dentro da área do cliente durante o cálculo de tempo de permanência. O sistema compara a coordenada GPS do dispositivo com a coordenada-base do cliente e, se a distância entre elas for menor que o raio configurado, considera que o vendedor está no local.

Telas impactadas

Tela	Contexto
ADM010 — Parâmetros do Sistema	Campo editável na aba Roteirização
Roteirização / Monitoramento GPS	Utilizado no cálculo de tempo de permanência

Campos envolvidos

Campo	Tabela	Tipo	Descrição
QT_METROSRAIO	PARMSISTEMA	INTEGER	Raio em metros para verificação de proximidade
DSPOSICAOGPS	LOCALIZACAOGPS	VARCHAR	Coordenada GPS registrada pelo dispositivo
DTLOCALIZACAO	LOCALIZACAOGPS	TIMESTAMP	Data/hora da leitura GPS

Comportamento

O parâmetro é um valor numérico simples (inteiro) que representa metros. Não possui opções discretas — trata-se de um campo livre onde o usuário define a metragem desejada.

Como funciona

O que faz	Detalhe
Define o raio de proximidade	O valor é convertido internamente em graus decimais (metros × 0.00001) para comparar com coordenadas GPS de latitude/longitude
Valor padrão	30 metros
Campo editável	Sim, livremente editável na aba Roteirização
Obrigatório	Sim (NOT NULL no banco)

Fluxo de utilização

1. A procedure CALCULA_TEMPOPERMANENCIA lê QT_METROSRAIO de PARMSISTEMA.
2. Para cada leitura GPS do dispositivo no dia, chama VERIFICA_COORDENADA passando a coordenada-base do cliente, a coordenada GPS do momento e o raio configurado.
3. VERIFICA_COORDENADA converte o raio de metros para graus decimais (V_VL_COORD = I_QT_METROS × 0.00001) e verifica se a coordenada GPS está dentro do quadrado formado pela coordenada-base ± raio.
4. Se todas as leituras consecutivas estiverem dentro do raio, o tempo de permanência é calculado pela diferença entre a primeira e a última leitura.

Simulação passo a passo

1. Acesse ADM010 — Parâmetros do Sistema.
2. Vá até a aba Roteirização.
3. No campo Qt Metros Raio, digite o valor desejado (ex.: 50).
4. Salve as alterações.
5. Ao executar o cálculo de tempo de permanência para um vendedor, o sistema considerará que ele está no cliente enquanto sua posição GPS estiver dentro de um raio de 50 metros da coordenada-base do cliente.

Resultado esperado: O tempo de permanência do vendedor no cliente será calculado com base no raio configurado. Um raio maior tende a aumentar o tempo detectado (tolerância maior); um raio menor tende a reduzir (mais precisão na proximidade).

Exceção / Importante:

• O cálculo usa uma aproximação baseada em graus decimais (metros × 0.00001), o que é razoavelmente preciso para distâncias pequenas em regiões tropicais, mas pode apresentar variação em latitudes extremas.
• Se o campo I_DS_COORDBASE (coordenada-base do cliente) ou os dados de DSPOSICAOGPS estiverem nulos, a procedure não executa o cálculo (O_QT_MINUTOS retorna 0).

Procedures impactadas

Referência direta ao campo

Procedure	Arquivo	Descrição
CALCULA_TEMPOPERMANENCIA	Scripts/CALCULA_TEMPOPERMANENCIA.sql	Lê QT_METROSRAIO de PARMSISTEMA e passa como parâmetro para VERIFICA_COORDENADA
VERIFICA_COORDENADA	Scripts/VERIFICA_COORDENADA.sql	Recebe o raio em metros e converte para graus decimais para verificar se uma coordenada está dentro do raio de outra

Candidatas por uso da tabela

As procedures abaixo referenciam a tabela PARMSISTEMA, mas não utilizam o campo QT_METROSRAIO diretamente:

ARRUMA_MASCARACONTA, ATUALIZA_CONTACONTABIL, CONTABILIZA_CUPOMFISCAL, ENDERECOPESSOA_BI0, GERA_CONTACLIFOR, GERA_DARF, GERA_PLANOFILIAL, GERA_SPEDBLOCOL, GERA_SPEDCONTABIL, GERA_SPEDCONTABIL_0000, GERA_SPEDECF, GERA_SPEDECFBLOCOJ, GERA_SPEDECFBLOCOK155, GERA_SPEDECFBLOCOK355, GERA_SPEDECFBLOCOL210, GERA_SPEDECFBLOCOY, GRAVA_REGISTROSPED0500, IMPORTA_ARQUIVOMAGNETICO, INCLUI_IMPOSTONOTACTB, INSERE_ITEMNOTACC

Valores de referência

Valor (metros)	Efeito prático
10	Raio muito restrito — exige precisão GPS elevada; pode subestimar permanência
30	Padrão — equilíbrio entre precisão e tolerância
50	Tolerância maior — útil em áreas com sinal GPS instável
100	Raio amplo — pode superestimar o tempo de permanência