Sommaire
Pysae est en capacité de piloter le système billettique embarqué à bord des véhicules via une connexion sans fil basée sur l'utilisation d'un routeur WIFI/4G.
Cela permet de mutualiser la prise de service du conducteur réalisée sur le SAEIV avec la billettique. Ainsi, on limite le nombre de manipulations du conducteur sur les systèmes embarqués, et on fait gagner un temps précieux aux conducteurs.
💡Principe
La mutualisation de la prise de service du conducteur permet de transmettre directement la prise de service via Pysae vers la billettique Kuba.
Le connecteur entre Pysae et Kuba permet de transmettre au pupitre billettique Kuba la prise de service réalisée par le conducteur sur son pupitre SAEIV Pysae de manière automatique, afin d'avoir qu'une seule saisie.
Pysae transmet via le connecteur toutes les informations nécessaires à l'ouverture du service agent sur la billettique (identification conducteur) et au démarrage de la billettique sur le service réalisé (identification service).
✅ Pré-requis techniques
Vous devez disposer des équipements suivants :
Pupitre Billettique Kuba
Smartphone ou tablette
Support de fixation
Connexion data
Routeur Wifi 4G (pour jouer le rôle de passerelle entre les différents équipements embarqués)
📝Plan de transport et champs nécessaires
Assurez-vous que vos plans de transport (au format GTFS) soient identiques dans vos solutions Pysae et Kuba. Il est possible de récupérer le GTFS publié dans Pysae via l'API plan de transport.
Champs du GTFS nécessaires pour communiquer entre Pysae et KUBA
Champ Kuba | Source / Champ GTFS | Note |
societe_ligne | Saisie manuelle (en dur) | À configurer dans l'interface Pysae Op (Paramètres d'intégration) |
societe_agent | Saisie manuelle (en dur) | À configurer dans l'interface Pysae Op (Numéro d'équipe) |
num_cond | staffNumber | Matricule conducteur |
numParc | fleetNumber | Numéro de véhicule |
ref_ext_course | trip_id | Utilisé systématiquement (nettoyé de ses préfixes) |
ref_ext_ligne | routeShortName | Nom court de la ligne |
ref_ext_arret | stopId | Identifiant de l'arrêt |
service | blockId | Identifiant du service agent |
sens | directionId + 1 | Sens de la course |
Identifiant de course (ref_ext_course) : Contrairement aux versions précédentes, le système utilise désormais systématiquement le trip_id pour identifier les courses, même si un trip_short_name est présent dans le GTFS.
💻Configuration dans Pysae
1/ Paramétrage
Rendez-vous dans l'onglet "Intégrations" en bas à gauche de votre interface d'exploitation (Op). Cliquez sur le bouton "Activer" dans l'encadré Kuba.
2/ Code Société Agent
Afin de configurer le code "societe_agent", vous devez affecter un numéro d'équipe à une équipe existante ou nouvellement créée.
Le champ "societe_agent" sera renseigné pour chaque appareil par la valeur du numéro de son équipe, il est donc nécessaire de renseigner une équipe par appareil.
3/ Code Société Ligne
Un nouveau champ "societe_ligne" est disponible dans la configuration du connecteur. Vous devez y renseigner le code spécifique fourni par votre autorité organisatrice (ex: spécifications Région PDL).
Note : Ce champ est désormais indépendant de l'agency_id du GTFS et doit être saisi "en dur" dans l'interface.
4/ Ajout de l'IP/Port de connexion
L'IP ainsi que le port de connexion correspondent à ceux de l'équipement KUBA (à demander auprès de KUBA).
5/ Local port
Ce port est utilisé pour recevoir les réponses de l'équipement KUBA (à demander auprès de KUBA).
6/ Sélection du champ d'identification des courses
Le connecteur est désormais configuré pour utiliser par défaut le trip_id (nettoyé) afin de garantir une correspondance parfaite avec les systèmes Kuba, conformément aux dernières exigences contractuelles.
N'oubliez pas de cliquer sur le bouton "Enregistrer" après toute modification.