> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/reports/specific-report-details/speed-violation-report.md).

# Relatório de violação de velocidade

O **Violação de velocidade** **relatório** detecta e lista cada episódio em que um veículo excedeu um limite de velocidade definido. Defina a velocidade permitida e a duração mínima que um episódio deve ter para ser incluído, e o relatório encontrará todos os intervalos correspondentes nos dados.

Ao contrário dos alertas, que notificam em tempo real, o **Violação de velocidade** **relatório** é uma ferramenta de análise retrospectiva. Ela funciona examinando os dados de rastreamento gravados em busca de pontos de dados consecutivos acima do limite, o que significa que pode detectar episódios que talvez tenham sido perdidos por regras ou notificações.

<figure><img src="/files/3dc56cf66d1b2748d224e4feb4df90d051f78a19" alt="Speed violations report"><figcaption><p>Relatório de violação de velocidade</p></figcaption></figure>

### Casos de uso do relatório de violação de velocidade

* **Cumprimento da política**: verifique se os motoristas permaneceram dentro de um limite de velocidade da empresa ou específico da rota ao longo de um dia, semana ou mês inteiro.
* **Avaliação de risco**: identifique os episódios de excesso de velocidade mais frequentes ou mais graves para concentrar o treinamento de segurança nos motoristas ou rotas certos.
* **Comparação de motoristas**: Ativar **Agrupar por motoristas** para ver qual motorista teve o maior número ou a maior duração de violações durante os períodos atribuídos.
* **Investigação de incidentes**: após um acidente ou uma reclamação de cliente, localize a violação específica — seu horário, duração, velocidade máxima e o endereço onde o pico ocorreu.
* **Filtragem por duração mínima**: filtre picos de velocidade breves (por exemplo, ruído de GPS ou uma ultrapassagem momentânea) exigindo uma duração mínima da violação, para que apenas o excesso de velocidade sustentado seja relatado.

### Parâmetros do relatório de violação de velocidade

* **Ocultar abas vazias:** Quando ativado, as abas de dispositivos (ou motoristas) sem violações são omitidas completamente do relatório, em vez de exibir a mensagem "nenhuma violação encontrada".
* **Exibir segundos:** Controla se as durações são exibidas como `hh:mm:ss` ou `hh:mm`.
* **Duração da violação (obrigatória)**: o tempo mínimo, em minutos, que um episódio de excesso de velocidade deve durar para aparecer no relatório. Episódios mais curtos do que isso são descartados silenciosamente. Defina como 0 para incluir até os picos mais breves. Intervalo válido: 0–1440 (24 horas).
* **Velocidade permitida (obrigatória)**: o limite de velocidade em km/h (ou mph, dependendo do seu sistema de medição). Qualquer período contínuo acima desse valor é detectado como uma violação. Intervalo válido: 1–400.
* **Agrupar por motorista:** quando ativado, o relatório é organizado em seções separadas por motorista com base no histórico de atribuição de motoristas. Se um motorista não tiver sido atribuído durante parte do período, esses intervalos são atribuídos a um motorista não identificado.
* **Usar filtro inteligente:** Exclui viagens curtas ou inválidas do relatório. Uma viagem regular é excluída se tiver menos de 3 pontos de dados, percorrer menos de 100 metros ou permanecer dentro de um diâmetro de 200 metros. Além disso, pontos individuais do trajeto com padrões de quilometragem suspeitos (por exemplo, velocidades implausivelmente altas ou baixas) são removidos.

### Como ler o relatório de violação de velocidade

#### Gráfico de velocidade

Cada aba de dispositivo começa com um gráfico de série temporal que cobre todo o período do relatório. Ele exibe duas sobreposições:

* Velocidade (linha azul): a velocidade do veículo ao longo do tempo.
* Distância percorrida (área verde): distância acumulada percorrida no mesmo período.

Uma linha horizontal vermelha de marcação é desenhada no limite de velocidade permitido, para que você possa ver visualmente onde e por quanto tempo a linha de velocidade excede o limite.

O eixo temporal do gráfico usa o fuso horário do usuário. Lacunas de mais de 30 minutos entre pontos de dados são tratadas como interrupções no gráfico, em vez de serem conectadas como uma única linha.

#### Tabela de violações de velocidade

Abaixo do gráfico, uma tabela lista cada violação detectada, agrupada por dia. Uma linha separadora antes de cada dia mostra a data e o número de violações naquele dia. O título da tabela também exibe o limite configurado e a duração mínima — por exemplo: *"Violações de velocidade (acima de 60 km/h com duração de 5 min. ou mais)"*.

Colunas:

* **Hora de início**: quando o veículo excedeu a velocidade permitida pela primeira vez.
* **Duração**: por quanto tempo a violação durou (do primeiro ponto acima do limite até o primeiro ponto no limite ou abaixo dele, ou até uma lacuna de 30 minutos ou mais).
* **Velocidade média**: a velocidade média durante a violação. Calculada com base na distância percorrida e na duração do episódio.
* **Velocidade máxima**: a maior velocidade registrada durante a violação.
* **Endereço**: a localização onde a velocidade de pico foi registrada (convertida em um endereço de rua).

### Observações importantes

* Este relatório não tem aba de **Resumo** aba. Cada dispositivo (ou cada seção de motorista, ao agrupar por motoristas) recebe sua própria aba, sem agregação entre dispositivos.
* As velocidades do rastreador são sempre armazenadas internamente em km/h. A velocidade permitida informada e todos os valores exibidos são convertidos automaticamente para o seu sistema de medição (km/h ou mph).
* Uma violação termina quando a velocidade cai para ou abaixo da velocidade permitida, ou quando há uma lacuna de mais de 30 minutos entre pontos de dados. Essas duas condições são verificadas separadamente — uma lacuna de 30 minutos sempre encerra a violação atual, mesmo que o próximo ponto ainda esteja acima do limite.
* O filtro de duração mínima usa uma comparação estritamente maior que: um episódio com duração exatamente igual à duração mínima é excluído; ele precisa durar pelo menos um segundo a mais para ser incluído.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/pt-br/guide/reports/specific-report-details/speed-violation-report.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
