Entités vers Formes GTFS (Conversion)

Synthèse

Crée un fichier shapes.txt pour un jeu de données de transport en commun GTFS selon les représentations des lignes d’itinéraires créées par l’outil Générer des entités de forme à partir de GTFS.

Le fichier GTFS shapes.txt en option contient une représentation des chemins géographiques empruntés par les véhicules de transport dans un système de transport. Un fichier shapes.txt approprié est important pour les applications de calcul d’itinéraire basées sur GTFS pour afficher correctement les itinéraires de transport sur la carte. Même si de nombreuses entreprises de transport génèrent leurs fichiers shapes.txt via les traceurs GPS de leurs véhicules, d’autres entreprises de transport non équipées de ce matériel peuvent rencontrer des problèmes pour créer ce fichier.

Avec cet outil, ainsi que l’outil Générer des entités de forme à partir de GTFS, créez un fichier shapes.txt basé sur les informations relatives aux arrêts, aux itinéraires et aux horaires depuis un jeu de données GTFS existant. Une fois l’outil Générer des entités de forme à partir de GTFS exécuté pour estimer les chemins parcourus par les véhicules dans le système de transport et les résultats affinés selon les connaissances locales, vous pouvez exécuter cet outil pour convertir ces entités linéaires en un nouveau fichier shapes.txt. L’outil crée également un fichier GTFS stop_times.txt, le champ shape_dist_traveled étant renseigné selon les valeurs correspondant aux nouvelles formes.

Utilisation

  • La plupart des entrées de cet outil doivent être les sorties de l’outil Générer des entités de forme à partir de GTFS. Ces deux outils ont pour vocation d’être utilisés ensemble.

  • Le champ shape_dist_traveled dans le fichier GTFS stop_times.txt indique à quelle distance se situe un arrêt spécifique sur une ligne de transport. Par exemple, si un bus parcourt 1,5 miles (1,6 km) pour atteindre le 5e arrêt d’un itinéraire, la valeur shape_dist_traveled pour cet arrêt est définie sur 1,5. Le champ shape_dist_traveled doit s’accroître pour chaque arrêt de l’itinéraire. La distance parcourue jusqu’au 5e arrêt devrait être supérieure à la distance parcourue jusqu’au 4e arrêt et inférieure à la distance parcourue jusqu’au 6e arrêt, par exemple.

    L’outil Entités vers Formes GTFS utilise une procédure de référencement linéaire pour calculer les valeurs du champ shape_dist_traveled pour les arrêts. Dans certains cas, les valeurs calculées pour les arrêts séquentiels le long de l’itinéraire ne peuvent pas être revues à la hausse. L’outil génère un message d’avertissement indiquant quelles formes, le cas échéant, rencontrent ce problème. Ce problème survient généralement lorsque la géométrie linéaire de la forme en entrée se superpose sur elle-même ou contient des boucles. Par conséquent, il est important de passer en revue et de modifier les lignes de forme avant d’exécuter cet outil pour veiller à ce que les lignes de forme soient aussi nettes et appropriées que possible. Si un bus circule dans les deux sens dans une même rue et s’auto-superpose sur l’axe médian, cela peut permettre de décaler légèrement chaque direction de la ligne de forme d’un côté ou de l’autre de l’axe médian.

Paramètres

ÉtiquetteExplicationType de données
Lignes de forme en entrée

Classe d’entités linéaires représentant les formes GTFS créées en exécutant l’outil Générer des entités de forme à partir de GTFS. La classe d’entités doit contenir un champ shape_id avec des valeurs correspondant aux valeurs du champ shape_id dans les autres entrées de l’outil.

Feature Layer
Arrêts de forme en entrée

Classe d’entités ponctuelles représentant les arrêts GTFS associés à chaque forme créée en exécutant l’outil Générer des entités de forme à partir de GTFS. Si un arrêt de transport est utilisé par plusieurs formes, l’arrêt doit être dupliqué dans cette classe d’entités pour chaque forme qui l’utilise.

La classe d’entités doit contenir un champ shape_id avec des valeurs correspondant aux valeurs du champ shape_id dans les autres entrées de l’outil. Elle doit également contenir un champ stop_id avec des valeurs correspondant à celles de la colonne shape_id du fichier GTFS stop_times.txt en entrée.

Feature Layer
Trajets GTFS mis à jour en entrée

Le fichier GTFS trips.txt mis à jour créé en exécutant l’outil Générer des entités de forme à partir de GTFS. Dans ce fichier, la colonne shape_id doit avoir les valeurs correspondant à celles des champs shape_id dans les autres entrées de l’outil.

File
Durées d’arrêt GTFS en entrée

Fichier stop_times.txt d’origine issu du jeu de données GTFS qui était utilisé lors de l’exécution de l’outil Générer des entités de forme à partir de GTFS.

File
Formes GTFS en sortie

Fichier GTFS shapes.txt en sortie.

File
Durées d’arrêt GTFS en sortie

Fichier GTFS stop_times.txt en sortie. Ce fichier contient le champ shape_dist_traveled avec les valeurs issues des nouvelles formes.

File
Unités de distance
(Facultatif)

Précise les unités de distance à utiliser pour renseigner le champ shape_dist_traveled dans les fichiers GTFS en sortie.

  • MilesL’unité est exprimée en miles. Il s’agit de l’option par défaut.
  • MètresL’unité est exprimée en mètres.
  • KilomètresL’unité est exprimée en kilomètres.
String

arcpy.conversion.FeaturesToGTFSShapes(in_shape_lines, in_shape_stops, in_gtfs_trips, in_gtfs_stop_times, out_gtfs_shapes, out_gtfs_stop_times, {distance_units})
NomExplicationType de données
in_shape_lines

Classe d’entités linéaires représentant les formes GTFS créées en exécutant l’outil Générer des entités de forme à partir de GTFS. La classe d’entités doit contenir un champ shape_id avec des valeurs correspondant aux valeurs du champ shape_id dans les autres entrées de l’outil.

Feature Layer
in_shape_stops

Classe d’entités ponctuelles représentant les arrêts GTFS associés à chaque forme créée en exécutant l’outil Générer des entités de forme à partir de GTFS. Si un arrêt de transport est utilisé par plusieurs formes, l’arrêt doit être dupliqué dans cette classe d’entités pour chaque forme qui l’utilise.

La classe d’entités doit contenir un champ shape_id avec des valeurs correspondant aux valeurs du champ shape_id dans les autres entrées de l’outil. Elle doit également contenir un champ stop_id avec des valeurs correspondant à celles de la colonne shape_id du fichier GTFS stop_times.txt en entrée.

Feature Layer
in_gtfs_trips

Le fichier GTFS trips.txt mis à jour créé en exécutant l’outil Générer des entités de forme à partir de GTFS. Dans ce fichier, la colonne shape_id doit avoir les valeurs correspondant à celles des champs shape_id dans les autres entrées de l’outil.

File
in_gtfs_stop_times

Fichier stop_times.txt d’origine issu du jeu de données GTFS qui était utilisé lors de l’exécution de l’outil Générer des entités de forme à partir de GTFS.

File
out_gtfs_shapes

Fichier GTFS shapes.txt en sortie.

File
out_gtfs_stop_times

Fichier GTFS stop_times.txt en sortie. Ce fichier contient le champ shape_dist_traveled avec les valeurs issues des nouvelles formes.

File
distance_units
(Facultatif)

Précise les unités de distance à utiliser pour renseigner le champ shape_dist_traveled dans les fichiers GTFS en sortie.

  • MILESL’unité est exprimée en miles. Il s’agit de l’option par défaut.
  • METERSL’unité est exprimée en mètres.
  • KILOMETERSL’unité est exprimée en kilomètres.
String

Exemple de code

Exemple 1 d’utilisation de l’outil Entités vers formes GTFS (fenêtre Python)

Ce script montre comment exécuter l’outil FeaturesToGTFSShapes dans la fenêtre Python.

arcpy.transit.FeaturesToGTFSShapes(
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
    r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
    r"C:\Data\GTFSShapes\trips_new.txt",
    r"C:\Data\GTFS\stop_times.txt",
    r"C:\Data\GTFSShapes\shapes_new.txt",
    r"C:\Data\GTFSShapes\stop_times_new.txt",
    "Kilometers")

Environnements

Cas particuliers

Générateur de nombres aléatoires

Seule la partie initiale de cette variable d’environnement est utilisée. Le type de générateur est ignoré.