# Lógica de detecção de estacionamento

### Introdução

A detecção de estacionamento é uma configuração central que define viagens, paradas, marcha lenta e outros eventos relacionados ao movimento para uma unidade na Navixy. A lógica combina velocidade, tempo mínimo de inatividade e, quando disponível, dados adicionais, como ignição ou status do sensor de movimento.

Antes de revisar relatórios ou alertas, certifique-se de que o dispositivo envie dados consistentes e de que a configuração corresponda à operação real da frota.

<img src="/files/a751d618fe470e5f38bc6b8eba87d29c5ff8ff4b" alt="" height="336" width="624">

Configure isso em **Detecção de estacionamento**. Isso afeta diretamente:

* Relatório de viagens
* Relatório de paradas
* Marcha lenta excessiva
* Paradas dentro ou fora de cercas geográficas
* Regras que dependem do movimento ou do status de estacionamento

<img src="/files/ece34b2409e9036f9eb13c27595882633db077cb" alt="" height="519" width="624">

A plataforma interpreta apenas os dados que recebe. Baixa frequência de envio, ruído de GPS, status de ignição incorreto ou dados de movimento não confiáveis afetarão o resultado.

### Configuração principal

Em **Detecção de estacionamento**, você define quando a plataforma deve tratar uma unidade como estacionada.

<img src="/files/e2c89baa86774bc374f0b3aa63d8d2d984c74ff1" alt="" height="404" width="624">

* **Detecção mínima de inatividade**: O tempo mínimo que a unidade deve permanecer inativa antes de a plataforma marcá-la como estacionada. Se isso for definido como 5 minutos, a condição deverá se manter por 5 minutos completos antes de o status mudar. Intervalo permitido: de 1 a 1440 minutos.
* **Velocidade máxima em marcha lenta**: O limite de velocidade usado para tratar a unidade como inativa. Se isso for definido como 3 km/h, a plataforma trata velocidades abaixo de 3 km/h como inativas. Se isso for definido como 0, a detecção de velocidade em marcha lenta será desativada.
* **Considerar status da ignição**: Inclui o status do motor em **Detecção de estacionamento**. Para isso funcionar corretamente, o sensor de ignição deve estar fisicamente conectado e configurado em **Sensores e botões**. Se você ativar isso sem um sensor válido, os resultados poderão estar incorretos.
* **Considerar sensor de movimento**: Inclui o movimento informado pelo dispositivo, além da velocidade e do tempo. Isso pode ajudar quando o ruído de GPS causa movimento falso, mas somente se os dados do sensor forem confiáveis.

### Como a lógica funciona sem ignição ou sensor de movimento

<img src="/files/b68e486dfa10904d29e3534a02a3e592a583e781" alt="" height="405" width="624">

Se essas opções estiverem desativadas, a plataforma usa apenas velocidade e tempo:

1. A velocidade cai abaixo do **Velocidade máxima em marcha lenta**.
2. A plataforma começa a contar o tempo.
3. Se o **Detecção mínima de inatividade** for atendido, a unidade será marcada como estacionada.
4. Se um pacote chegar com velocidade acima do limite, a contagem é reiniciada.

Exemplo:

Se a inatividade estiver definida como 5 minutos e a velocidade estiver definida como 3 km/h, a plataforma deverá receber dados abaixo de 3 km/h por 5 minutos contínuos antes de marcar a unidade como estacionada. Um pacote acima do limite reinicia a contagem.

### Como a lógica muda ao considerar a ignição

A velocidade sozinha nem sempre consegue distinguir entre uma parada operacional, trânsito, espera com o motor ligado ou o fim de uma viagem. A ignição adiciona contexto e ajuda a separar esses cenários.

Quando essa opção está ativada, a plataforma avalia velocidade, tempo e status do motor. Se o status da ignição estiver invertido, ausente ou intermitente, a detecção poderá estar incorreta.

Exemplo:

A unidade esteve a 0 km/h por vários minutos.

* **Ignição desligada** → a plataforma pode confirmar o estacionamento com maior certeza
* **Ignição ligada** → pode estar em espera com o motor funcionando, o que pode alimentar regras como marcha lenta excessiva
* **Ignição configurada incorretamente** → a plataforma pode interpretar incorretamente ambos os casos

### Como a lógica muda ao considerar o sensor de movimento

Quando essa opção está ativada, a plataforma usa o status de movimento informado pelo dispositivo para complementar os dados de velocidade e tempo.

Isso ajuda quando a unidade está parada, mas o ruído de GPS cria pequenos deslocamentos de posição ou falsas baixas velocidades. Nesse caso, o sensor pode confirmar que a unidade não está realmente se movendo.

Se o sensor informar dados incorretos, o efeito pode ser o oposto: viagens divididas, paradas atrasadas ou movimento falso enquanto a unidade estiver parada. Valide o sensor antes de ativá-lo.

### Valores recomendados

Use estes valores como ponto de partida para operações urbanas:

* **Detecção mínima de inatividade**: de 3 a 5 minutos
* **Velocidade máxima em marcha lenta**: de 3 a 6 km/h

Esses não são valores universais. Eles dependem da operação e do que você considera uma parada.

* Para operações em que paradas curtas importam, um tempo menor pode ser usado.
* Para operações com trânsito frequente ou rotas lentas, use um tempo maior para reduzir ruído nos relatórios.
* Valide o limite de velocidade com dados reais. Se o GPS informar entre 1 e 4 km/h enquanto a unidade estiver parada, um limite muito baixo pode impedir a detecção correta.

### Boas práticas

* **Configure a Detecção de estacionamento primeiro**: Antes de revisar alertas como marcha lenta excessiva ou paradas em cercas geográficas, valide se a detecção básica funciona corretamente.
* **Valide a ignição antes de ativá-la**: O sensor deve existir em **Sensores e botões** e informar valores corretos. Caso contrário, isso pode afetar viagens, paradas e alertas.
* **Não ative o sensor de movimento sem validar os dados**: Primeiro confirme que o dispositivo envia esse status corretamente. Caso contrário, isso pode afetar o registro de viagens e a detecção de paradas.
* **Revise a frequência de envio**: Se o dispositivo enviar dados a cada 60 segundos, um tempo de inatividade de 1 minuto não é adequado. O tempo mínimo deve ser maior do que o intervalo de envio.
* **Valide com relatórios reais**: Após alterar a configuração, revise os relatórios do dia operacional:
  * Relatório de viagens
  * Relatório de paradas
  * Relatório de estacionamento, se aplicável
* **Documente as alterações**: Registre o valor anterior, o novo valor, a data, o motivo e os dispositivos afetados. Caso contrário, será difícil explicar posteriormente as alterações nos relatórios.

Se você observar viagens divididas, paradas fantasmas ou eventos que não correspondem à operação, ajuste os valores e valide novamente.

### Casos comuns

* **A unidade está parada, mas parece estar se movendo**: O **Velocidade máxima em marcha lenta** pode estar muito baixo, ou pode haver ruído de GPS. Se o dispositivo informar entre 1 e 4 km/h enquanto a unidade estiver parada, aumente o limite.
* **Muitas viagens curtas aparecem**: O **Detecção mínima de inatividade** está muito baixo. A plataforma encerra viagens devido a semáforos ou pequenas pausas. Aumente o tempo e revise novamente.
* **A unidade aparece estacionada, embora esteja se movendo lentamente**: O **Velocidade máxima em marcha lenta** está muito alto. Se a unidade opera em baixa velocidade e o limite estiver acima disso, a plataforma a interpreta como inativa.
* **A marcha lenta excessiva não é acionada**: O alerta depende de o status de estacionado ser confirmado primeiro e de o status da ignição chegar corretamente. Se **Detecção de estacionamento** não estiver funcionando corretamente, o alerta não será acionado mesmo que a ignição esteja ligada. Revise **Detecção de estacionamento** primeiro e, depois, o alerta.
* **Diferença entre marcha lenta da plataforma e marcha lenta do hardware**: A marcha lenta da plataforma depende da lógica da Navixy, da detecção de estacionamento e do status de ignição recebido. A marcha lenta do hardware vem de um evento gerado diretamente pelo dispositivo.
* **A viagem não é registrada corretamente ao usar o sensor de movimento**: Se o sensor informar dados incorretos, a viagem pode não ser delimitada como esperado. Revise primeiro os dados do sensor.
* **A detecção muda após ativar a ignição**: Antes de presumir que isso é um problema da plataforma, revise o status da ignição que está chegando do dispositivo.

### Recomendação para evitar lacunas na rota

Revise estes itens primeiro:

* Detecção mínima de inatividade
* Velocidade máxima em marcha lenta
* Frequência de envio do dispositivo
* Velocidade informada durante o período
* Qualidade do sinal de GPS
* Uso de GPS ou LBS
* Status da ignição, se aplicável, e sua configuração em **Sensores e botões**
* Sensor de movimento, se aplicável, e se ele informa corretamente
* Regras da plataforma e do hardware ativas ao mesmo tempo

A plataforma aplica a lógica configurada aos dados que recebe. Se os pacotes chegarem com baixa frequência, ruído ou valores inconsistentes, o resultado refletirá essas condições.

### Observação final

**Detecção de estacionamento** não corrige os dados do dispositivo. Ela apenas interpreta os dados recebidos com base nos valores configurados. Se a ignição ou o sensor de movimento estiver ativado, esses dados também passam a fazer parte da lógica.

Antes de ajustar regras ou relatórios, certifique-se de que o dispositivo envie dados consistentes o suficiente para corresponder à operação real.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/gps-devices/parking-detection-logic.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
