La position du véhicule est utilisée pour fournir des informations générées automatiquement sur l'emplacement d'un véhicule à partir d'un appareil GPS présent à bord. Une seule position peut être fournie pour chaque véhicule concerné.
Le trajet en cours du véhicule doit être transmis par le biais d'un descripteur de trajet. Vous pouvez également fournir un descripteur de véhicule qui définit un véhicule précis pour lequel vous fournissez les mises à jour. La documentation est présentée ci-dessous.
Vous pouvez fournir un horodatage indiquant l'heure du relevé de la position. Il s'agit d'un horodatage distinct de l'horodatage de l'en-tête du flux, ce dernier correspondant à l'heure à laquelle le message a été généré par le serveur.
Le passage en cours peut également être fourni (en tant que stop_sequence ou stop_id). Il correspond soit au prochain arrêt prévu pour le véhicule, soit à l'arrêt où il se trouve déjà.
Position
Le champ position contient les données de localisation dans VehiclePosition. Il est obligatoire de renseigner la longitude et la latitude, mais les autres champs sont facultatifs. Il existe différents types de données :
- Latitude : distance angulaire entre la position et l'équateur, exprimée en degrés, dans le système de coordonnées WGS-84
- Longitude : distance angulaire entre la position et le méridien de référence, exprimée en degrés, dans le système de coordonnées WGS-84
- Orientation : direction prise par le véhicule
- Kilométrage : distance parcourue par le véhicule
- Vitesse : vitesse instantanée du véhicule, exprimée en mètres par seconde
Densité du trafic
La position du véhicule permet également à l'agence d'indiquer la densité du trafic que le véhicule rencontre actuellement. La densité peut être classée selon les catégories suivantes :
- Trafic inconnu
- Trafic fluide
- Ralentissements
- Embouteillages
- Embouteillages majeurs
Il incombe à l'agence de déterminer votre classement pour chaque type de trafic. Nous conseillons d'utiliser la catégorie "Embouteillages majeurs" uniquement dans le cas où le trafic est tellement saturé que les conducteurs quittent leur véhicule.
Taux d'occupation
La position du véhicule permet également à l'agence de préciser le degré d'occupation du véhicule par les passagers. Le taux d'occupation peut être classé selon les catégories suivantes :
- Vide
- Nombreux sièges disponibles
- Quelques sièges disponibles
- Places debout disponibles uniquement
- Peu de places debout restantes
- Complet
- Ne prend pas de passagers
Ce champ est encore expérimental et susceptible d'être modifié. À l'avenir, il pourra être officiellement intégré.
VehicleStopStatus
L'état du véhicule vis-à-vis de l'arrêt fournit plus de précisions quant à la position d'un véhicule par rapport à un arrêt vers lequel il se dirige ou qu'il a atteint. Il peut être défini par chacune des valeurs suivantes :
- En approche de : le véhicule est sur le point d'arriver à l'arrêt indiqué
- Arrêté à : le véhicule est arrêté à l'arrêt indiqué
- En transit vers : l'arrêt indiqué est le prochain arrêt du véhicule (par défaut)
Descripteur de véhicule
Le descripteur de véhicule détaille les caractéristiques d'un véhicule spécifique. Il peut contenir chacun des attributs suivants :
- Identifiant : système interne d'identification du véhicule. L'identifiant est propre à chaque véhicule.
- Libellé : libellé visible par l'utilisateur, par exemple le nom d'un train.
- Plaque d'immatriculation : plaque d'immatriculation actuelle du véhicule.