Mesure¶

Ce qu'on tire de l'exploitation une fois le service assuré : les distances, la régularité, la fréquentation, et la trace conservée de tout cela.

trip-km¶

Kilomètres parcourus — la distance réalisée, ventilée par course, par véhicule ou par période. Sert à la facturation au kilomètre, au suivi contractuel et au dimensionnement du parc.

Pas d'identifiant propre : la donnée s'obtient par période et par périmètre.

Les kilomètres à vide, parcourus hors course commerciale, sont portés par le service de conduite — voir duties.

punctuality¶

Ponctualité — la mesure de l'écart entre l'horaire prévu et l'heure de passage réelle, agrégée sur une période. C'est l'indicateur de qualité de service le plus suivi par les autorités organisatrices.

Pas d'identifiant propre : la donnée s'obtient par période et par périmètre.

La mesure s'appuie sur les horaires théoriques — voir stop-times — et sur les passages observés.

Un passage qu'un boîtier télématique a fait avant que sa girouette affiche la ligne, reconstitué une fois la ligne affichée, n'est compté ni dans l'agrégat ni dans l'export. Il reste dans l'historique des passages ; le fil de course (trip-details-feed) le signale par headsign_missing: true.

Profils de ponctualité — les seuils qui classent un écart en cinq niveaux : grosse avance, avance, à l'heure, retard, gros retard. Chaque réseau en définit un ou plusieurs (par exemple urbain et interurbain), en minutes entières signées, et y rattache ses lignes ; le profil par défaut porte toutes les lignes qu'aucun autre profil ne porte. Un écart est en avance s'il vaut au plus early × 60 secondes, en retard s'il vaut au moins late × 60, et de même pour les gros niveaux.

Une fois les profils enregistrés, driver_ontime_interval ne se modifie plus : il vaut [early × 60 + 1, late × 60] du profil par défaut, pour que les applications conducteur qui ignorent les profils classent comme les autres.

passenger-counts¶

Comptage voyageurs — le nombre de montées et de descentes relevé aux arrêts, par course. Il provient des systèmes de comptage embarqués, et alimente le dimensionnement de l'offre.

Pas d'identifiant propre : la donnée s'obtient par période et par périmètre.

stats¶

Statistiques — la famille transverse des endpoints d'agrégation et d'export. Ce n'est pas une entité au sens des autres entrées : le tag rassemble les restitutions calculées sur les entités précédentes, sous deux formes constantes — un agrégat sous /stats/, un export CSV sous /export/.

Les huit exports CSV du spec datahub — courses, conducteurs, véhicules, alertes, ponctualité, kilomètres, suivi de course, comptage voyageurs — constituent la voie recommandée pour alimenter un entrepôt de données. Ils sont décrits dans les exemples de collecte.

history¶

Historique — la conservation de ce qui s'est produit, au-delà de la fenêtre temps réel : événements remontés par les appareils, horaires observés aux arrêts, GTFS en vigueur aux dates concernées, kilomètres relevés. C'est la source à interroger pour reconstituer une journée passée.

Pas d'identifiant propre : l'historique s'interroge par périmètre et par période.

Les horaires observés conservés ici sont à distinguer des horaires prévus, qui appartiennent au référentiel théorique — voir stop-times.

Un changement de course ne constitue pas un passage à un arrêt. Les passages de la nouvelle course sont enregistrés à partir de ses propres remontées d'arrêt ; ceux de la course précédente sont conservés.