> 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/analytics/fr/iot-query/schema-overview/transformation-layer/common-transformations/rule-based-driver-events.md).

# Événements du conducteur basés sur des règles

Comment la table des événements de conduite basée sur des règles transforme vos règles d'alerte en enregistrements d'infractions de conduite, et comment l'interroger.

La transformation des événements de conduite basée sur des règles enregistre les infractions au volant sous forme d’événements individuels, évalués selon les règles d’alerte configurées sur votre compte. Chaque ligne dans `processed_common_data.rule_based_driver_events` représente une infraction : quelle règle l’a détectée, de quel type elle était, quand et où elle s’est produite, et à quelle vitesse le véhicule roulait à ce moment-là.

Contrairement à la transformation basée sur un déclencheur qu’elle remplace, celle-ci s’exécute selon un calendrier fixe. Une fonction d’actualisation réévalue une fenêtre de données récentes toutes les 15 minutes ; une nouvelle ligne peut donc avoir jusqu’à 15 minutes de retard par rapport à l’événement sur l’appareil.

{% hint style="info" %}

* Les seuils d’excès de vitesse et de marche au ralenti proviennent de vos propres règles d’alerte, et non des paramètres par défaut de la plateforme. Deux appareils peuvent générer des événements différents malgré une conduite identique si des règles différentes s’appliquent à chacun.
* Les événements matériels répétés du même type provenant du même appareil dans un délai de 10 secondes sont regroupés sur une seule ligne, car un appareil peut envoyer plusieurs signaux pour un même incident.
* Les événements basés sur l’accéléromètre sont ignorés lorsque le véhicule roule à moins de 3 km/h. Cela évite de signaler comme une infraction les vibrations dues au chargement ou au stationnement.
* Tous les horodatages sont stockés en UTC.
  {% endhint %}

## Table de sortie : processed\_common\_data.rule\_based\_driver\_events

Chaque ligne représente une infraction détectée. La table est indexée par `device_id`, `device_time`, `rule_id`, et `hw_event_id`.

Plusieurs colonnes sont des copies dénormalisées de valeurs stockées ailleurs, de sorte que les requêtes de tableau de bord les plus courantes ne nécessitent aucune jointure : `object_label` provient de l’enregistrement de l’objet, et `speed_limit`, `event_comment1` et `event_comment2` proviennent de la règle à l’origine de l’événement.

<table><thead><tr><th width="180">Champ</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>device_id</code></td><td>entier</td><td>Identifiant de l’appareil.</td></tr><tr><td><code>object_id</code></td><td>entier</td><td>Identifiant de l’objet (véhicule ou actif) associé à l’appareil au moment de l’événement.</td></tr><tr><td><code>object_label</code></td><td>texte</td><td>Nom d’objet lisible par un humain. Déjà dénormalisé dans cette table, il n’est donc pas nécessaire de faire une jointure avec <code>raw_business_data.objects</code> est nécessaire.</td></tr><tr><td><code>device_time</code></td><td>horodatage</td><td>Horodatage de l’événement, en UTC.</td></tr><tr><td><code>rule_id</code></td><td>entier</td><td>La Règle d'alerte à l'origine de l'événement. Références <code>raw_business_data.rules</code>. Définissez sur <code>0</code> pour <code>rpm_exceeded</code> événements qui ne sont pas déclenchés par une règle. Voir <a href="#how-rules-shape-the-output">Comment les règles façonnent la sortie</a>.</td></tr><tr><td><code>event_type</code></td><td>texte</td><td>Catégorie de violation. L’une des quatre valeurs. Voir <a href="#violation-types">Types de violations</a> ci-dessous.</td></tr><tr><td><code>hw_event_id</code></td><td>entier</td><td>Code d’événement matériel pour les infractions détectées par l’accéléromètre et le capteur. <code>0</code> pour <code>speedup</code> et <code>idling_soft</code>, qui sont déduits et non transmis par l’appareil.</td></tr><tr><td><code>event_comment1</code></td><td>texte</td><td>Libellé en texte libre copié depuis la règle. Défini lors de la configuration de la règle, il permet de regrouper les événements selon vos propres catégories. Null pour <code>rpm_exceeded</code>.</td></tr><tr><td><code>event_comment2</code></td><td>texte</td><td>Deuxième libellé en texte libre copié depuis la règle. Null pour <code>rpm_exceeded</code>.</td></tr><tr><td><code>speed_limit</code></td><td>entier</td><td>Le seuil configuré dans la règle, dénormalisé à partir de <code>raw_business_data.rules</code>. Pour <code>speedup</code> règles, il s’agit de la limite de vitesse en km/h ; pour <code>idling_soft</code> Pour les règles, il s’agit de la tolérance de ralenti en minutes.</td></tr><tr><td><code>speed_kmh</code></td><td>numérique</td><td>Vitesse du véhicule au moment de l’événement, en km/h.</td></tr><tr><td><code>duration_sec</code></td><td>entier</td><td>Durée de l’infraction en secondes, pour les types d’événements qui s’étendent sur une période plutôt que de se produire instantanément.</td></tr><tr><td><code>zone_id</code></td><td>entier</td><td>Zone géographique dans laquelle l’événement s’est produit, lorsque la règle s’applique à des zones spécifiques. Null si aucune zone n’est associée à la règle, ainsi que lorsque la règle est configurée pour se déclencher en dehors de ses zones. Voir <a href="#zone-scoping">Portée de la zone</a>.</td></tr><tr><td><code>zone_label</code></td><td>texte</td><td>Nom de zone géographique lisible par une personne, dénormalisé à côté de <code>zone_id</code>.</td></tr><tr><td><code>latitude</code></td><td>double précision</td><td>Latitude en degrés.</td></tr><tr><td><code>longitude</code></td><td>double précision</td><td>Longitude en degrés.</td></tr><tr><td><code>extra_value</code></td><td>numérique</td><td>Mesure dépendante du contexte, définie pour les types d’événements qui enregistrent une valeur autre que la vitesse. Pour <code>rpm_exceeded</code> événements, la valeur de TR/MIN qui a déclenché l’événement.</td></tr><tr><td><code>created_at</code></td><td>horodatage</td><td>Lorsque la ligne a été écrite par la fonction d’actualisation. Après <code>device_time</code> jusqu’à la durée d’un cycle d’actualisation.</td></tr></tbody></table>

### Types de violations

Le tableau ci-dessous répertorie chaque type d’infraction enregistré par la transformation, ainsi que l’ `event_type` la valeur qui lui est attribuée et la source de son seuil. Utilisez le `event_type` valeur de la colonne directement lors du filtrage ou du regroupement des requêtes.

<table><thead><tr><th width="150">valeur de event_type</th><th width="230">Signification</th><th width="150">hw_event_id</th><th>Seuil</th></tr></thead><tbody><tr><td><code>speedup</code></td><td>Le véhicule a dépassé la limite de vitesse définie dans la règle</td><td><code>0</code></td><td>Par règle, en km/h</td></tr><tr><td><code>harsh_driving</code></td><td>Accéléromètre ou événement matériel signalé par l’appareil : accélération brutale, freinage, virages, changements de voie et infractions au port de la ceinture de sécurité</td><td><code>900</code>, <code>931</code>, <code>987</code>–<code>991</code>, <code>996</code></td><td>Détecté par l'appareil. Ignoré en dessous de 3 km/h</td></tr><tr><td><code>idling_soft</code></td><td>Véhicule à l’arrêt avec le contact mis pendant une durée supérieure à celle autorisée par la règle</td><td><code>0</code></td><td>Par règle, en minutes</td></tr><tr><td><code>rpm_exceeded</code></td><td>Régime moteur supérieur au seuil de la plateforme</td><td><code>9002</code></td><td>Fixé à 5,000 TR/MIN</td></tr></tbody></table>

{% hint style="warning" %}
Le `event_type` valeurs, et le `hw_event_id` numérotation, diffèrent du tableau des événements de performance du Conducteur que cette transformation remplace. Les requêtes rédigées pour l’ancienne table doivent avoir leurs valeurs de filtre mises à jour, et pas seulement le nom de la table. En particulier, les infractions liées à la ceinture de sécurité n’ont plus leur propre type d’événement : elles sont transmises sous la forme `harsh_driving` avec `hw_event_id = 931`.
{% endhint %}

Les exemples ci-dessous montrent des modèles de requêtes courants. La requête de base renvoie les violations récentes, triées par appareil et par heure. La deuxième ajoute la définition de la règle associée à chaque événement. La troisième ne conserve que les cas de conduite agressive détectés par le matériel.

{% tabs %}
{% tab title="Requête de base" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    objet_label,
    device_time,
    event_type,
    speed_kmh,
    speed_limit,
    latitude,
    longitude
FROM processed_common_data.rule_based_driver_events
WHERE device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}
{% endtab %}

{% tab title="Avec les détails de la règle" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    e.device_id,
    e.object_label,
    e.device_time,
    e.event_type,
    e.speed_kmh,
    e.speed_limit,
    e.event_comment1,
    r.maximum AS rule_threshold
FROM processed_common_data.rule_based_driver_events e
LEFT JOIN raw_business_data.rules r
    ON r.rule_id = e.rule_id
WHERE e.device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY e.device_id, e.device_time;
```

{% endcode %}

Utilisez un `LEFT JOIN` plutôt qu’une jointure interne. `rpm_exceeded` les événements transportent `rule_id = 0` et n'ont aucune ligne correspondante dans `raw_business_data.rules`, de sorte qu'une jointure interne les exclut sans avertissement.
{% endtab %}

{% tab title="Conduite agressive uniquement" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    objet_label,
    device_time,
    hw_event_id,
    speed_kmh
FROM processed_common_data.rule_based_driver_events
WHERE event_type = 'harsh_driving'
  AND device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}

Filtrage sur un seul `event_type` la valeur remplace la longue `IN` répertorier le tableau précédent requis, puisque toutes les violations liées à l’Accéléromètre et au matériel appartiennent désormais à une seule catégorie. Séparez-les avec `hw_event_id` lorsque vous avez besoin de la manœuvre individuelle.
{% endtab %}
{% endtabs %}

## Comment les règles façonnent la sortie

Les lignes de ce tableau ne sont pas générées par la logique de détection à l’échelle de la plateforme. À l’exception de `rpm_exceeded`, chaque événement est le résultat d'une règle d'alerte configurée sur votre compte, et cette règle détermine à la fois le seuil et la portée.

{% stepper %}
{% step %}

#### La règle définit le seuil

Chaque règle stocke son seuil dans `raw_business_data.rules.maximum` : une vitesse en km/h pour `speedup` règles, une durée en minutes pour `idling_soft` règles. La transformation copie cette valeur dans `speed_limit` sur chaque ligne qu’il écrit, afin que vous puissiez voir à quelle référence le véhicule a été comparé sans avoir à joindre à nouveau la règle.
{% endstep %}

{% step %}

#### La règle définit le périmètre

Une règle s’applique aux objets qui lui sont associés par `rules2objects`, et éventuellement aux zones géographiques associées par l’intermédiaire de `rules2zones`. Un appareil qui ne figure pas dans la liste des objets d'une règle ne génère aucun événement pour cette règle, quelle que soit sa conduite.
{% endstep %}

{% step %}

#### La règle fournit ses propres libellés

`event_comment1` et `event_comment2` sont des champs de texte libre renseignés lors de la configuration de la règle. Ils sont copiés dans chaque événement afin que les tableaux de bord puissent afficher votre propre terminologie sans jointure.
{% endstep %}

{% step %}

#### La fonction d’actualisation évalue la fenêtre

Toutes les 15 minutes, `refresh_rule_based_driver_events` réexamine une fenêtre de 40 minutes de données récentes et écrit tous les événements qui remplissent les critères. La fenêtre est volontairement plus longue que l’intervalle, afin que les enregistrements qui parviennent tardivement à la plateforme soient quand même pris en compte lors d’un passage ultérieur.
{% endstep %}

{% step %}

#### TR/MIN fait exception

`rpm_exceeded` les événements ne sont pas régis par des règles. Ils utilisent un seuil fixe de la plateforme de 5,000 TR/MIN et comportent `rule_id = 0`, et ne présentent aucune `event_comment1` ou `event_comment2` valeurs.
{% endstep %}
{% endstepper %}

### Portée des zones

Lorsqu’une règle est associée à des zones géographiques via `rules2zones`, ces zones déterminent à la fois si un événement est enregistré et si `zone_id` est renseigné. La géométrie des zones est lue depuis `processed_common_data.zones_geom`, matérialisée à partir de `raw_business_data.zones`.

<table><thead><tr><th width="260">Configuration de la règle</th><th width="200">Événements enregistrés</th><th>Valeur de zone_id</th></tr></thead><tbody><tr><td>Aucune zone associée</td><td>Partout</td><td>Nul</td></tr><tr><td>Zones associées, <code>zone_inverted = false</code></td><td>Uniquement à l’intérieur des zones</td><td>La zone où l’événement s’est produit</td></tr><tr><td>Zones associées, <code>zone_inverted = true</code></td><td>Uniquement à l’extérieur des zones</td><td>Nul</td></tr></tbody></table>

{% hint style="warning" %}
Une valeur nulle `zone_id` est ambiguë à elle seule : cela peut signifier que la règle n’avait aucune zone ou qu’elle se déclenche en dehors de ses zones. Filtrer avec `WHERE zone_id IS NULL` regroupera ces deux cas. Faites une jointure avec `rules2zones` pour les distinguer.
{% endhint %}

<details>

<summary>Constantes fixes de la plateforme</summary>

Ces valeurs sont identiques pour tous les comptes et ne peuvent pas être configurées dans une règle. Les seuils définis par les règles sont présentés dans [Comment les règles influent sur le résultat](#how-rules-shape-the-output).

<table><thead><tr><th width="220">Constant</th><th width="160">Valeur</th><th>Description</th></tr></thead><tbody><tr><td>Vitesse minimale pour les événements de l'accéléromètre</td><td>3 km/h</td><td>Les infractions détectées par l’accéléromètre en dessous de cette vitesse sont ignorées afin d’éviter de signaler les vibrations lorsque le véhicule est stationné ou en cours de chargement.</td></tr><tr><td>Seuil de TR/MIN</td><td>5,000 TR/MIN</td><td>Le régime moteur doit dépasser cette valeur pour un <code>rpm_exceeded</code> événement à enregistrer.</td></tr><tr><td>Fenêtre de déduplication matérielle</td><td>10 secondes</td><td>Les événements matériels répétés du même type provenant du même appareil pendant cette période sont fusionnés en un seul événement.</td></tr><tr><td>Intervalle d’actualisation</td><td>15 minutes</td><td>Fréquence d’exécution de la fonction d’actualisation.</td></tr><tr><td>Période de recherche rétrospective de l’actualisation</td><td>40 minutes</td><td>Période de données réexaminée à chaque exécution afin de ne pas manquer les enregistrements arrivés tardivement.</td></tr></tbody></table>

</details>

## Personnaliser la transformation

Pour `speedup` et `idling_soft`, la personnalisation ne nécessite aucun workflow. Les deux seuils sont lus à partir de la règle d'alerte ; toute modification de la règle change donc les données enregistrées par la transformation à partir de la prochaine actualisation. Il en va de même pour le périmètre : modifiez les objets ou les zones géographiques associés à la règle pour changer les véhicules et les zones qui génèrent des événements.

{% hint style="warning" %}
La fonction d’actualisation qui renseigne `processed_common_data.rule_based_driver_events` ne peut pas être modifié directement. Les seuils qui ne sont pas définis par une règle, comme le seuil minimal de l’accéléromètre de 3 km/h ou la limite de 5,000 TR/MIN, ne peuvent être modifiés qu’en créant un workflow parallèle dans Transformation Builder et en le programmant comme une transformation distincte dans `processed_custom_data`. Cela ne change pas la table décrite sur cette page.
{% endhint %}

Si votre scénario opérationnel nécessite des seuils fixes différents, contactez **<iotquery@navixy.com>** pour demander le modèle de workflow correspondant. Une fois que vous l’avez, chargez-le dans [Générateur de transformations](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/transformation-layer/transformation-builder.md), ajustez les valeurs pertinentes et planifiez le workflow modifié en tant que transformation personnalisée.

## Étapes suivantes

* [**Transformations courantes**](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/transformation-layer/common-transformations.md): Retour à l’index des transformations.
* [**Trajets**](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/transformation-layer/common-transformations/trips.md): Une transformation associée qui génère des enregistrements de trajets de véhicules à partir des données télématiques brutes.
* [**Agrégation des Données du capteur**](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/transformation-layer/common-transformations/sensor-data-aggregation.md) : Une transformation sœur qui regroupe les relevés des capteurs par intervalles de temps.
* [**Couche de données brutes**](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/bronze-layer.md) : Explorer `tracking_data_core`, `states` et `inputs`, les tables sources qui alimentent les événements de conduite basés sur des règles.
* [**Générateur de transformations**](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/transformation-layer/transformation-builder.md): Découvrez comment créer une version personnalisée de cette transformation.
* [**Tableau de bord du score de conduite**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/12-driver-performance-dashboard.md): Utilise les événements de conduite basés sur des règles pour évaluer la sécurité de la conduite à l’échelle de la flotte.
* [**Tableau de bord de l’impact des comportements**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/13-behavior-impact-dashboard.md): Utilise les événements de conduite basés sur des règles pour suivre l’évolution des tendances comportementales.
* [**Tableau de bord de la sécurité et de la sûreté**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/10-premium-safety-security-dashboard.md): Utilise les événements de conduite basés sur des règles ainsi que les données des zones géographiques et des trajets.
* [**Tableau de bord du leasing**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/06-leasing-dashboard.md): Utilise les requêtes de détection de conduite agressive et de ralenti de la section Événements conducteur basés sur des règles.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/fr/iot-query/schema-overview/transformation-layer/common-transformations/rule-based-driver-events.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
