Obtention du fichier Excel Type
A la création du plan de transport, vous générez un plan de transport vide. Au bas de la page d’accueil, vous avez la possibilité de générer puis télécharger le plan de transport au format excel type. Le plan de transport peut ainsi être réalisé depuis l'outil Excel.
Le fichier Excel généré contient plusieurs onglets :
agency
stops
routes
calendar
calendar_dates
trips
Définition des caractéristiques du réseau
Agency
Il s'agit du nom de l'agence(collectivité territoriale ou entreprise) dans laquelle vous travaillez. Cet onglet se remplit généralement de la façon suivante :
agency_id : 1
agency_name : nom de l'agence
agency_url : lien renvoyant vers le site de votre agence
agency_timezone : généralement Europe/Paris
Stops
Dans cet onglet, vous référencez l’ensemble des arrêts de votre réseau :
stop_id : Correspond à l’identifiant unique de l’arrêt. Il peut s’agir d’un numéro ou d’un nom;
stop_name: Nom de l’arrêt;
stop_lat : Latitude du point d’arrêt au format;
stop_long : Longitude du point d’arrêt.
Les noms d’arrêts définis dans stop_name correspondent aux arrêts à mentionner dans les courses.
Routes
Dans cette onglet sont référencées les différentes lignes qui composent votre réseau :
route_id : identifiant de ligne. Il s’agit d’un identifiant alphanumérique unique;
route_short_name : nom de ligne court. Il s’agit du nom figurant dans le bandeau de couleur associé à la ligne; présent entre autres sur la vue Carte de la plateforme d’exploitation ou dans l’application pour les voyageurs;
route_long_name : nom de ligne long. Il s’agit généralement du descriptif de ligne.;
route_type : type de ligne. Ce champ fait référence au moyen de transport associé. Si il s’agit d’un bus ou d’un car, il faut indiquer “3” dans la cellule;
route_color: couleur de la ligne.
Pour la définition de la ligne, attention à ne pas être redondant entre le route_short_name et le route_long_name; les deux noms apparaissant souvent ensemble dans l’application. Une bonne pratique peut être par exemple d’indiquer le numéro ou la lettre associé à la ligne en route_short_name et les deux terminus en route_long_name.
Concernant le choix de la couleur de la ligne, vous pouvez sélectionner la couleur qui vous convient à l’aide de l’outil “color picker” de Google.
Définition des jours de circulation
Calendar
Dans cet onglet vous indiquez les identifiants de calendrier associés aux courses de votre réseau. Ces identifiants indiquent non seulement les jours de la semaine pendant lesquels la course est active mais également la période de l’année (période scolaire ou vacances scolaires par exemple) :
service_id : identifiant de calendrier. Il va s’agir de l’identifiant relié à la course pour connaitre sa période d’activité. Il est donc conseillé de choisir un identifiant parlant indiquant la période et les jours d’ouverture (ex: Scolaire_LMJV);
start_date : date de début. Il s’agit du premier jour du calendrier pour lequel les courses associées sont actives;
end_date : date de fin. Il s’agit du dernier jour du calendrier pour lequel les courses associées sont actives;
monday : lundi;
tuesday : mardi;
wednesday : mercredi;
thursday : jeudi;
friday : vendredi;
saturday : samedi;
sunday : dimanche.
Il faut indiquer les jours pour lesquels l’identifier de calendrier est actif et les jours pour lesquels il ne l’est pas. Pour cela il faut indiquer “1” dans la cellule si il est actif et “0” si il est inactif. Il est nécessaire de bien remplir chacune des cellules relatives aux jours.
Calendar_dates
L’onglet calendar_dates est complémentaire de l’onglet calendar. Il est nécessaire de le remplir consciencieusement pour achever la définition des calendriers. Il s’agit en effet des exceptions associées à un identifiant de calendrier :
service_id : identifiant de calendrier (il s’agit dans la grande majorité des cas des mêmes identifants que dans l’onglet calendar);
date : date à laquelle l’exception du calendrier va s’appliquer;
exception_type : type d’exception. Il peut s’agir d’un jour pour lequel la course s’applique exceptionnellement; il faut alors indiquer “1” dans la cellule. Il s’agit sinon d’un jour pour lequel la course ne s’applique pas (cas le plus fréquent); il faut alors indiquer “2”.
Si une exception s’applique pendant une période donnée, il vous suffit de recopier l’identifiant de calendrier et le type d’exception sur plusieurs lignes et de faire défiler les dates (Excel gère bien le passage d’un jour au suivant) dans la colonne correspondante.
Exemple de bonne pratique
Définir un identifiant de calendrier scolaire dans “calendar” : Scolaire_LMmJV (actif du lundi au vendredi)
Choisir une plage de dates très large : 01/01/2020 dans start_date et 31/12/2021 dans end_date par exemple
L’identifiant est relatif à des courses circulant du lundi au vendredi. Il faut donc indiquer 1 pour monday, tuesday, wednesday, thursday et friday. Il faut indiquer 0 pour saturday et sunday.
Il faut à présent enlever dans “calendar_dates” toutes les périodes de vacances scolaires pendant lesquelles les courses associées à l’identifiant de service ne sont pas actives. Pour cela il faut indiquer Scolaire_LMmJV, choisir la date du premier jour des vacances (Février par exemple), puis indiquer “2” en type d’exception. Il suffit ensuite de faire défiler les dates pour couvrir toutes les vacances de février. Reproduire enfin cette étape pour chaque période de vacances.
Regroupement des courses par dessertes
Trips
Dans l’onglet trips, vous regroupez les courses par desserte. Dans cet onglet, les deux champs à remplir obligatoirement sont les suivants :
route_id : identifiant de ligne défini dans l’onglet routes du fichier Excel;
service_id : identifiant de calendrier défini dans les onglets calendar et calendar_dates;
Il n’est pas nécessaire de remplir le trip_id qui correspond à l’identifiant unique associé à chacune des courses. En effet, il est généré automatiquement à partir de la ligne (route_id) associée, dans l’ordre de définition des courses.
Par défaut, le fichier comporte également deux champs optionnels qui permettent d’améliorer l’affichage de la course dans l’interface :
trip_headsign : girouette de la course. Il peut s’agir en premier lieu du dernier arrêt de la course afin de renseigner la destination;
trip_short_name : nom de course court.
Il est recommandé de remplir le trip_headsign car la girouette est référencée à plusieurs endroits dans les différentes interface.
Enfin, lors de l’export, votre fichier peut comporter (ou vous pouvez les ajouter) les champs suivants :
shape_id : identifiant de tracé associé à la course. Il s’agit du tracé de ligne correspondant à l'enchaînement des arrêts de la course. Les tracés peuvent être réalisés dans l’outil d’édition du plan de transport, avant ou après la définition des courses. Le shape_id peut être un nombre ou un nom selon vos préférences.
block_id : identifiant de service. Il s’agit du service auquel la course est rattachée, un service étant un enchaînement de plusieurs courses. Si vous fonctionnez en mode service, vous pouvez définir les services dans l’outil d’édition du plan de transport, avant ou après la définition des courses.
Si ces deux champs ne sont pas présents dans le fichier, vous pouvez les ajouter en dessous du service_id (ligne 6 et 7 du fichier).
Une fois ces différents champs remplis, il est nécessaire de laisser une ligne vide entre le dernier champ rempli et le premier arrêt de la course.
Vous devez ensuite indiquer l'enchaînement des arrêts dans la première colonne (en dessous de la cellule laissée vide). Les noms d’arrêts doivent être strictement identiques à ceux définis dans l’onglet stops.
Pour terminer, il faut indiquer les horaires de chacune des courses au format “HH:MM:SS”
Desserte
Un onglet trips correspond à une desserte donnée. Les onglets doivent nécessairement commencer par “trips_”. Il est conseillé pour s’y retrouver d’indiquer ensuite la ligne et le sens (aller ou retour). En effet, il faut bien un onglet par sens étant donné que enchaînement des arrêts est différent
Dans un même onglet trips, il est possible de référencer également des courses desservant une seule partie des arrêts présents dans l’onglet. Il faut pour cela laisser la cellule vide au niveau des horaires, pour les arrêts non desservis.