Mapping CHOUETTE - HUB Correspondance entre éléments de données HUB et objets de la base Chouette

Transcription

1 CHOUETTE Maintenance, accompagnement et recette de logiciels pour les échanges de données multimodales Mapping CHOUETTE - HUB Correspondance entre éléments de données HUB et objets de la base Chouette Auteurs : Relecteurs Zakaria BOUZIANE Michel ETIENNE, Marc FLORISSON Novembre 2014 Résumé : CHOUETTE est un logiciel libre développé à l'initiative du ministère français chargé des transports (et du développement durable) dans le but de faciliter l'échange de données d'offre (théorique) de transport collectif (TC), en s'appuyant pour cela sur la norme NFP 99506, dite Neptune, qui spécifie un profil d'échange XML. Les utilisateurs visés sont les collectivités locales Autorités Organisatrices de Transport (AOT), les exploitants des réseaux TC, ainsi que leurs prestataires (bureaux d'étude ou société de services) et d'autres acteurs tels que services de l'état, éditeurs de logiciels, opérateurs de services d'information, chercheurs... L'application CHOUETTE est disponible sous la forme d'une application WEB destinée à être déployée sur un serveur WEB, et d'une application en ligne de commande. Ce document établit la correspondance entre les attributs des objets de la Base Chouette et les champs de fichiers au format HUB. Agence française pour l'information multimodale et la billettique

2 Informations sur ce document : Organisme commanditaire : AFIMB Titre : Mapping CHOUETTE - HUB Sous-titre : Organismes auteurs CITYWAY Rédacteurs Zakaria BOUZIANE Participants Michel ETIENNE, Marc FLO- RISSON Maitre d'ouvrage AFIMB Mots clés : Diffusion : profil d'échange Neptune, information multimodale, application Chouette, HUB Nombre de pages : 21 pages Date Novembre 2014 publique (licence Creative Commons CC-by-nd ) Confidentialité : Bibliographie : Non Oui Historique des versions / révisions : Version Date d application Description des changements Auteur /11/2014 Initialisation du document. Z. BOUZIANE /11/2014 Prise en compte des retours de M. ETIENNE /11/2014 Ajout d'un paragraphe sur les conditions du bon fonctionnement de l'export HUB das Chouette et d'un autre paragraphe sur les conditions de la bonne validité des fichiers HUB exportés depuis Chouette /11/2014 Prise en compte des retours de M. FLO- RISSON. Z. BOUZIANE Z. BOUZIANE Z. BOUZIANE

3 Table des matières 1Introduction Conditions d'export HUB Conditions de validité du HUB exporté depuis Chouette...5 2Modèles de donnés Modèle HUB Modèle Chouette Table de correspondance HUB Chouette...7 3Règles de conversion Généralités Réseau Transporteur Groupe de lignes Lignes Arrêts Communes Correspondances Itinéraires Missions Courses Renvoi Horaires Modes de transports Opérations...21

4 1 INTRODUCTION Ce document établit la correspondance entre les attributs des objets chouette et les champs des fichiers HUB (format interne du groupe Transdev, utilisé notamment par le logiciel TDO). seuls les fichiers suivants sont exploités : ARRET.TXT CHEMIN.TXT COMMUNES.TXT CORRESPONDANCE.TXT COURSE.TXT COURSE_OPERATION.TXT DIRECTION.TXT GROUPELIGNE.TXT HORAIRE.TXT LIGNE.TXT MODETRANSPORT.TXT PERIODE.TXT RENVOI.TXT RESEAU.TXT SCHEMA.TXT TRANSPORTEUR.TXT Ces fichiers sont spécifiés dans HUB V1.4 TDO 4.5. Note : Ce document est amené à évoluer durant la période de déploiement sur le Site du SISMO afin de répondre aux cas particuliers qui n'auraient pas encore été identifiés. 1.1.Conditions d'export HUB Pour que l'export HUB puisse fonctionner et produire des résultats, les données dans Chouette doivent respecter les consignes suivantes : Bien que Chouette sauvegarde ses données en base au Format UTF-8, les noms des «Network», «Company», «GroupOfLine», «Line», des «StopArea», des «JourneyPattern», ainsi que les «city_name», les «nearest_topic_name» et les

5 «comment» ne doivent pas contenir des caractères non ISO (Le caractère œ n'est pas ISO ). 1.2.Conditions de validité du HUB exporté depuis Chouette Les données HUB produites par un Export HUB depuis l'application Chouette, peuvent être incomplètes fautes de disponibilité d'informations requises. Ici on liste l'ensemble des conditions permettant la production d'un Export HUB complet et suffisant. Cette liste est détaillée dans le document de spécification des tests HUB : L'identifiant Neptune «ObjectId» est sous le format : [préfixe]:[type d'objet]:[identifiant technique]. L'Export HUB s affranchit du [préfixe] et du [type d'objet] pour ne garder que [identifiant technique] qui sera utilisé comme Code pour les données HUB. Le format HUB impose des exigences sur la taille maximale du Code en fonction des objets (voir les tables du paragraphe 3 Règles de conversion). Pour que le HUB produit par Export depuis Chouette respecte cette règle, il faut s'assurer que les identifiants Neptune des données dans Chouette respectent ces limitations. Certaines données dans Chouette sont optionnelles. Leur absence est tolérée par Chouette. Lors de l'export au format HUB, ces données optionnelles seront traduites en champs vides, ce qui peut rendre les données HUB invalides. Les données exigés par le format HUB, pour le rendre valides sont spécifiées dans les tables du paragraphe 3 Règles de conversion. Pour que le HUB produit par Export depuis Chouette respecte cette règle, il faut s'assurer que les données Neptune permettant de les produire soient présentes dans Chouette. Les correspondances dans le format HUB sont exclusivement entre des arrêts physiques. Il faut s'assurer que les correspondances dans Chouette souhaitées dans l'export HUB soient entre arrêts physiques. Toute LIGNE dans le format HUB appartient à un et un seul groupe de lignes «GROUPLIGNE». Pour que cette règle reste valide dans l'export HUB, il faut s'assurer que dans Chouette, chaque «Line» est incluse dans un et un seul «GroupOfLine».

6 2 MODÈLES DE DONNÉS 2.1.Modèle HUB Le schéma se limite aux objets échangés avec Chouette TRANSPORTEUR COMMUNES ARRET 2 CORRESPONDANCE RESEAU LIGNE 2..* Relation redondante GROUPELIGNE SCHEMA RENVOI 1..* Concordance implicite MODETRANSPORT CHEMIN DIRECTION Relation optionnelle et implicite HORAIRE Relation optionnelle PERIODE Relation redondante (chemin) COURSE COURSE_OPERATION

7 2.2.Modèle Chouette Le schéma se limite aux objets échangés en HUB HUB 2.3.Table de correspondance HUB Chouette Chouette RESEAU TRANSPORTEUR GROUPELIGNE LIGNE (+MODETRANSPORT et RENVOI) SCHEMA CHEMIN COURSE (+COURSE_OPERATION) ARRET, COMMUNES CORRESPONDANCE HORAIRE PERIODE Network Company GroupOfLines Line Route, StopPoint JourneyPattern VehicleJourney StopArea ConnectionLink VehicleJourneyAtStop Timetable

8 3 RÈGLES DE CONVERSION 3.1.Généralités Règles sur les identifiants : Les identifiants Neptune étant longs, un traitement est proposé pour les convertir dans le cadre de HUB Un identifiant Neptune est composé de 3 items : [préfixe]:[type d'objet]:[identifiant technique] A l'export : Exemple L'identifiant HUB sera [identifiant technique]. Il faut donc s'assurer que les objectids de même [type d'objet] ont le même [préfixe] ObjectId [identifiant technique] Identifiant HUB REZO1:StopArea: REZO1:StopArea:AZ_34 AZ_34 AZ_34 Les paragraphes qui vont suivre décrivent les règles de conversions des données Neptune au format HUB. La couleur saumon permet de préciser les données obligatoires du format HUB. Les autres données sont optionnelles et peuvent être vides. 3.2.Réseau Le RESEAU du HUB est mis en équivalence avec le Network de Neptune : Libellé HUB Type taille Description Network Code Texte 3 Code du réseau Identifiant HUB Nom Texte 75 Nom du réseau name Identifiant Entier 8 Identifiant unique du réseau L'id du Network depuis la base de données Chouette

9 3.3.Transporteur Le TRANSPORTEUR du HUB est mis en équivalence avec la Company de Neptune : Libellé HUB Type taille Description Company Code Texte 3 Code du transporteur Identifiant HUB Nom Texte 75 Nom du transporteur name Identifiant Entier 8 Identifiant unique du transporteur L'id du Company depuis la base de données Chouette 3.4.Groupe de lignes Le GROUPELIGNE du HUB est mis en équivalence avec le GroupOfLines de Neptune : Libellé HUB Type taille Description GroupOfLines Code Texte 6 Code du groupe de lignes Identifiant HUB Nom Texte 75 Nom du groupe de lignes name Identifiant Entier 8 Identifiant unique du groupe de lignes L'id du GroupOfLines depuis la base de données Chouette Dans le format HUB chaque LIGNE appartient à un et un seul GROUPELIGNE. Cette restriction par rapport à la norme Neptune nous contraint à exporter les données Neptune au format HUB selon le protocole suivant : Le Line de Neptune qui n'est dans aucun GroupOfLine sera exporté en LIGNE de HUB sans GROUPELIGNE. Le Line de Neptune qui est dans plusieurs GroupOfLine sera exporté en LIGNE de HUB avec un seul GROUPELIGNE ; le premier de la liste.

10 3.5.Lignes La LIGNE du HUB est mis en équivalence avec le Line de Neptune : Libellé HUB Type taille Description Line Code Texte 14 Code de la ligne Identifiant HUB Code commercial Texte 6 Code commercial de la ligne number Nom Texte 75 Nom de la ligne name Code de représentation Code sous-traitant Code transporteur Entier 8 Code de représentation Texte 10 Code de sous-traitant Texte 3 Code du transporteur Identifiant HUB du Company Code réseau Texte 3 Code du réseau Identifiant HUB du Network Code Groupe de lignes Texte 6 Code du groupe de lignes Identifiant HUB du premier GoupOfLine si la liste des GroupOfLines est non vide Identifiant Entier 8 Identifiant unique de la ligne L'id de la Line depuis la base de données Chouette 3.6.Arrêts L'ARRET du HUB est mis en équivalence avec le StopArea de Neptune : Libellé HUB Type taille Description StopArea Code Texte 6 1 Code de l'arrêt Identifiant HUB Nom Texte 75 Nom de l'arrêt name Description Texte Description (repère technique) 2 nearest_topic_name 1 La taille peut aller jusqu à 12 pour des versions spéciales de logiciels HUB. Dans l'export que nous produisons, cette limite peut-être dépassée.

11 Libellé HUB Type taille Description StopArea Type Texte 18 Type de l'arrêt : Générique, Physique, etc. Nom réduit Texte 6 1 Nom réduit de l arrêt générique d appartenance. A renseigner s il s agit d un arrêt physique X Réel 8 Coordonnées X de l'arrêt physique en Lambert 2 étendu Y Réel 8 Coordonnées Y de l'arrêt physique en Lambert 2 étendu Commune Texte 80 Nom de la commune d'appartenance "ONNNNNNNNNNNNNNNNN" si area_type="commercialstop- Point" ou "NNNNNNNNNNNNNNNNNN" si area_type="boradingposition" ou "Quay". Si en plus mobility_restricted_suitability=true remplacer le 14iem N par O ("ONNNNNNNNNNNNONNNN" ou "NNNNNNNNNNNNNONNNN") Identifiant HUB du StopArea parent si area_type="boradingposition" ou "Quay". La valeur de X après conversion de (longitude, latitude) en Lambert 2 étendue (srid=27562) si renseignés. La valeur de Y après conversion de (longitude, latitude) en Lambert 2 étendue (srid=27562) si renseignés. city_name si renseigné. Code INSEE Entier 5 Code INSEE de la commune zip_code 3 si renseigné. Commentaire Texte 255 Commentaire sur l'arrêt physique Identifiant Entier 8 Identifiant unique de l'arrêt physique comment si renseigné. registration_number si area_type="boradingposition" ou "Quay". 2 Uniquement pour des versions spéciales de logiciels HUB. 3 On utilise le code postal faute d'avoir le code INSEE.

12 3.7.Communes La COMMUNE du HUB est mise en équivalence avec le StopArea de Neptune : Libellé HUB Type taille Description StopArea Code INSEE Entier 5 Code INSEE pour les communes des arrêts Nom Texte 80 Nom de commune pour les communes des arrêts zip_code 3 city_name 3.8.Correspondances La CORRESPONDANCE du HUB est mise en équivalence avec le ConnectionLink de Neptune : Libellé HUB Type taille Description ConnectionLink Code Arrêt 1 Texte 6 1 Code de l'arrêt physique 1 Identifiant HUB du StopArea identifié par departure_id Identifiant Arrêt 1 Entier 8 Identifiant de l'arrêt physique 1 registration_number du StopArea identifié par departure_id Code Arrêt 2 Texte 6 1 Code de l'arrêt physique 2 Identifiant HUB du StopArea identifié par arrival_id Identifiant Arrêt 2 Entier 8 Identifiant de l'arrêt physique 2 registration_number du StopArea identifié par arrival_id Distance entre les deux arrêts Entier 4 Distance entre les deux arrêts en mètre link_distance Temps de parcours de la correspondance Entier 4 Temps de trajet entre l arrêt physique 1 et l arrêt physique 2 en seconde default_duration Identifiant Entier 8 Identifiant unique de la correspondance Un compteur allant de 1 au nombre de correspondances

13 3.9.Itinéraires Le SCHEMA du HUB est mise en équivalence avec le Route de Neptune et ses StopPoint(s) : Libellé HUB Type taille Description Route Code Ligne Texte 14 Code ligne de rattachement du schéma Identifiant HUB du Line identifié par line_id. Sens Entier 1 Sens du schéma : 1 si wayback = 'A' si non 2. 1 = sens Aller 2 = sens Retour Identifiant Entier 8 Identifiant HUB. Code Arret 1 Texte 6 1 Identifiant HUB du StopArea identifié par stop_area_id du premier StopPoint de ce Route (c'est-à-dire le StopPoint identifié par le id de ce Route comme route_id et par 0 comme position). Identifiant Arret 1 Entier 8 registration_number du StopArea identifié Code Arrêt 1. Code Arret 2 Texte 6 1 Identifiant HUB du StopArea identifié par stop_area_id du deuxième StopPoint de ce Route (c'est-à-dire le StopPoint identifié par le id de ce Route comme route_id et par 1 comme position). Identifiant Arret 2 Entier 8 registration_number du StopArea identifié Code Arrêt

14 Libellé HUB Type taille Description Route Code Arret n Texte 6 1 Identifiant HUB du StopArea identifié par stop_area_id du dernier StopPoint de ce Route (c'est-à-dire le StopPoint identifié par le id de ce Route comme route_id et par n-1 comme position. Le nombre total des Stop- Point de la Route étant n). Identifiant Arret n Entier 8 registration_number du StopArea identifié Code Arrêt n Missions Le CHEMIN du HUB est mis en équivalence avec le JourneyPattern de Neptune : Libellé HUB Type taille Description JourneyPattern Code Ligne Texte 14 Code ligne de rattachement du schéma. Code chemin Texte 30 Code du chemin. Identifiant HUB. Identifiant HUB du Line identifié par line_id du Route identifié par route_id. Identifiant chemin Entier 8 Identifiant unique du chemin. registration_number Nom chemin Texte 75 Nom commerciale du chemin. name Sens Entier 1 Sens du chemin : 1 = sens Aller 1 si wayback du Route identifié par route_id = 'A' si non 2. 2 = sens Retour Type Texte 5 Type du chemin : HLP ou COM. COM (On ne traite dans cette équivalence que les missions commerciales) Code représentation Entier 5 Code de Représentation des couleurs.

15 Libellé HUB Type taille Description JourneyPattern Code Arret 1 Texte 6 1 Code du premier Arrêt physique du chemin. Identifiant HUB du StopArea identifié par stop_area_id du premier StopPoint identifié par route_id. Les StopPoints sont ordonnés par position. Identifiant Arret 1 Entier 8 Identifiant du premier Arrêt physique du chemin. registration_number du StopArea identifié Code Arrêt 1. Distance 1 Entier 8 Distance en mètre entre le premier arrêt et le deuxième arrêt. Type arrêt 1 sur chemin Texte 18 Type de l arrêt si différent sur le chemin. Code Arret 2 Texte 6 1 Code du deuxième Arrêt physique du chemin. Identifiant HUB du StopArea identifié par stop_area_id du deuxième StopPoint identifié par route_id. Les StopPoints sont ordonnés par position. Identifiant Arret 2 Entier 8 Identifiant du deuxième Arrêt physique du chemin. registration_number du StopArea identifié Code Arrêt 2. Distance 2 Entier 8 Distance en mètre entre le deuxième arrêt et le troisième arrêt. Type arrêt 2 sur chemin Texte 18 Type de l arrêt si différent sur le chemin Code Arret n Texte 6 1 Code du dernier Arrêt physique du chemin. Identifiant HUB du StopArea identifié par stop_area_id du n ième StopPoint identifié par route_id. Les StopPoints sont ordonnés par position. Le nombre total des StopPoint de la Journey- Pattern étant n. Identifiant Arret n Entier 8 Identifiant du dernier Arrêt physique du chemin. registration_number du StopArea identifié Code Arrêt n.

16 Libellé HUB Type taille Description JourneyPattern Distance n Entier 8 Distance en mètre entre l'avant dernier arrêt et le dernier arrêt (pareil que Distance n-1). Type arrêt n sur chemin Texte 18 Type de l arrêt si différent sur le chemin Courses La COURSE du HUB est mise en équivalence avec le VehicleJourney de Neptune. Chaque VehicleJourney est associé à deux lignes dans le fichier HUB COURSE.TXT. Une ligne pour le départ de la course (Code de l arrêt physique de départ, son identifiant, D) et une autre pour l'arrivée (Code de l arrêt physique d'arrivée, son identifiant, A) : Libellé HUB Type taille Description VehicleJourney Numéro Entier 5 Numéro de la course. Index dans la liste des Vehicle- Journey valides (avec calendrier d'application) ordonnés par objectid. Service voiture Entier 4 Type matériel Entier 6 Service voiture d appartenance de la course. Libellé du type matériel à utiliser pour couvrir la course. Code Arrêt Texte 6 1 Code de l arrêt physique de passage (départ puis arrivée) de la course. Identifiant HUB du StopArea identifié par stop_area_id du StopPoint identifié par departure_stop_point_id (puis arrival_stop_point_id) du JourneyPattern identifié par journey_pattern_id.

17 Libellé HUB Type taille Description VehicleJourney Heure Entier 5 Heure, en nombre de secondes depuis minuit, du passage de la course à l'arrêt (de départ puis d'arrivée). Code ligne Texte 14 Ligne de rattachement de la course Code Chemin Texte 30 Chemin de rattachement de la course Heure, en nombre de secondes depuis minuit, du départ (puis arrivée) de la course au StopPoint identifié par departure_stop_point_id (puis celui identifié par arrival_stop_point_id) du JourneyPattern identifié par journey_pattern_id. Identifiant HUB du Line identifié par line_id du Route identifié par route_id. Identifiant HUB du JourneyPattern identifié par journey_pattern_id. Type Texte 1 Type de passage de la course : A : arrivée à l arrêt D pour le départ de la Vehicle- Journey et A pour son arrivée. D : départ de l arrêt Sens Entier 1 Sens de la course : 1 = Aller. 1 si wayback du Route identifié par route_id = 'A' si non 2. 2 = Retour. Validité Entier 4 Validité de la course ' ' logique sur tous les int_day_types des TimeTables de cette VehicleJourney. Graphique Texte 30 Identifiant arrêt Identifiants renvois Entier 10 Entier 8/renvoi Identifiant de l arrêt physique de passage (départ puis arrivée) de la course. Listes des identifiants des renvois alloués à la course séparée par le caractère. registration_number du StopArea de départ (respectivement d'arrivée). 1 si flexible_service = true (ce qui signifie l'utilisation du renvoi 1. Ce dernier défini la TAD)

18 Libellé HUB Type taille Description VehicleJourney Texte Codes périodes 6/période Liste des codes de Périodes de validité de la course séparés par le caractère. La liste des Identifiants HUB des TimeTables de cette VehicleJourney Séparés par le caractère. Catégorie Entier 1 Identifiant de la catégorie de la course : 1 : COM, 2 : SORTIE, 3 : RENTRE, 4 : HLP, 5 : PRISE, 6 : FIN, 7 : COUPUR, 8 : NAVET, 9 : DEPLCT, 10 : HCOND. 1 (On ne traite que les courses de commerciales) Identifiant Entier 8 Identifiant unique de la course. Identifiant HUB 3.12.Renvoi Dans le cas ou il y a dans les données une COURSE ou une LIGNE avec des facilités PMR, le fichier RENVOI.TXT existe et contient les deux lignes. RENVOI 1;PMR;1 Ce fichier peut contenir d'autres renvois, mais ne sont pas mis en équivalence avec des objets Neptune Horaires L'HORAIRE du HUB est mis en équivalence avec le VehicleJourneyAtStop de Neptune. Chaque VehicleJourneyAtStop est associé à deux lignes dans le fichier HUB HORAIRE.TXT. Une ligne pour l'heure de départ (D) et une autre pour l'heure d'arrivée (A) :

19 Libellé HUB Type taille Description VehicleJourneyAtStop Code Arrêt Texte 6 1 Code de l'arrêt Physique Identifiant HUB du StopArea identifié par le stop_area_id du StopPoint identifié par stop_point_id. Heure Entier 5 Heure de départ (puis d'arrivée), en nombre de secondes depuis minuit. Heure, en nombre de secondes depuis minuit : departure_time (puis arrival_time). Type Texte 1 Type de passage de l horaire : D : départ à l arrêt D si departure_time et A si arrival_time. A : arrivée à l arrêt Numéro de la course Numéro de la mission Entier 5 Numéro de la course. Index du VehicleJourney identifié par vehicle_journey_id dans la liste des VehicleJourney valides (avec calendrier d'application) ordonnés par objectid. Entier 5 Numéro de la mission. journey_pattern_id du Vehicle- Journey identifié par vehicle_journey_id dans la liste des VehicleJourney valides (avec calendrier d'application) ordonnés par objectid. Identifiant arrêt Entier 8 Identifiant de l'arrêt physique id du StopArea identifié par le stop_area_id du StopPoint identifié par stop_point_id. Identifiant Entier 8 Identifiant de l horaire de passage Numéro de la ligne HORAIRE à écrire (commence par 1 et se termine par 2 * nombre de Vehicle- JourneyAtStop valides) Modes de transports Le MODETRANSPORT du HUB est mis en équivalence avec la Line et VehicleJourney de Neptune :

20 Libellé HUB Type taille Description Line Code Texte 50 Code du mode de transport parmi la liste : AVION, BA- TEAU, BUS, BUS_PMR, CAR, CAR_PMR, FUNICULAIRE, ME- TRO, TAD, TAD_PMR, TAXI- BUS, TRAIN, TRAM, TROLLEY, VELO. Un mode parmi la liste des modes transport_mode_name de tous les Line et transport_mode de tous les VehicleJourney. Un mode par ligne dans le fichier HUB MODETRANSPORT.TXT. Commentaire Texte 255 Commentaire du mode de transport. Code ligne Texte 14 / ligne Liste des codes lignes affectés au mode de transport (séparateur ) La liste des Identifiants HUB des Line dont le mode transport_mode_name ou dont le mode transport_mode d'un VehicleJourney est ce Code Opérations Le COURSE_OPERATION du HUB est mis en équivalence avec le VehicleJourney de Neptune : Libellé HUB Type taille Description VehicleJourney Numéro de course Code opération Entier 10 Numéro de la course Index dans la liste des Vehicle- Journey valides (avec calendrier d'application) ordonnés par objectid. Texte 8 Code opération unique à la course. published_journey_identifier du VehicleJourney. Code lot Texte 8 Code identifiant du lot Code activité Texte 8 Code Activité

21 Libellé HUB Type taille Description VehicleJourney Mode de transport Texte 75 Mode de transport particulier à la course TAD si flexible_service = true, si non en fonction de transport_mode : - si Coach alors CAR ou CAR_PMR si mobility_restricted_suitability - si Bus alors BUS ou BUS_PMR si mobility_restricted_suitability - si Air alors AVION - si Waterborne ou Ferry alors BATEAU - si Metro alors METRO - si Taxi alors TAXIBUS - si Train ou LocalTrain ou Long- Distance_train alors TRAIN - si Tramway alors TRAM - si Trolleybus alors TROLLEY - si Bicycle alors VELO Champ libre 1 Texte Champ libre 2 Texte