Entités vers Formes GTFS (Conversion)

Résumé

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 shapes.txt GTFS en option contient une représentation des chemins géographiques pris par les véhicules de transport dans un système de transport. Un shapes.txt fichier 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 agences de transport génèrent leurs fichiers shapes.txt via des localisateurs GPS sur leurs véhicules, d’autres agences 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 stop_times.txt GTFS avec le champ shape_dist_traveled complété avec 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 stop_times.txt GTFS 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 sur 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 sur 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.

Syntaxe

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})

Paramètre	Explication	Type 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 shapes.txt GTFS en sortie.	File
out_gtfs_stop_times	Fichier stop_times.txt GTFS 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 compléter le champ shape_dist_traveled dans les fichiers GTFS en sortie. MILES —L’unité est exprimée en miles. Il s’agit de l’option par défaut. METERS —L’unité est exprimée en mètres. KILOMETERS —L’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 la fonction FeaturesToGTFSShapes dans la fenêtre Python.

arcpy.conversion.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

Générateur de nombres aléatoires

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é.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui