| Étiquette | Explication | Type de données |
Dossier GTFS en entrée | Dossier contenant un jeu de données GTFS valide pour lequel vous souhaitez créer un fichier shapes.txt. Le dossier doit contenir les fichiers GTFS stops.txt, trips.txt,routes.txt et stop_times.txt. | Folder |
Lignes de forme de transport en sortie | Classe d’entité linéaire représentant les formes d’itinéraire estimé calculées par cet outil. Chaque ligne de la sortie représente une forme unique requise pour ce jeu de données GTFS. Vous pouvez modifier la géométrie linéaire et utiliser cette classe d’entités comme entrée à l’outil Entités vers Formes GTFS. | Feature Class |
Arrêts de forme en sortie | Classe d’entités ponctuelles des arrêts de transport GTFS avec un ID les associant à chaque ligne de forme à créer par l’outil. Si le même arrêt GTFS est atteint par plusieurs formes, cette classe d’entités contiendra plusieurs copies de cet arrêt, une pour chaque forme à laquelle il est associé. Cette classe d’entités est utile avec les requêtes de définition lors de la modification d’une ligne de forme à la fois. Utilisez cette classe d’entités comme entrée à l’outil Entités vers Formes GTFS. Remarque :Cette classe d’entités en sortie n’équivaut pas à la sortie de l’outil Arrêts GTFS vers Entités. Cet outil produit une classe d’entités des arrêts GTFS exactement tels qu’ils sont dans le jeu de données d’origine ; il peut produire plusieurs copies de chaque arrêt pour les associer à différentes formes. Utilisez cette classe d’entités en sortie conjointement avec les autres sorties de l’outil Générer des entités de forme à partir de GTFS pour créer un fichier shapes.txt. | Feature Class |
Trajets GTFS en sortie | Fichier GTFS trips.txt en sortie. Ce fichier équivaut au fichier trips.txt dans le dossier GTFS en entrée, mais inclut le champ shape_id ajouté et complété avec les valeurs correspondant au champ shape_id dans la classe d’entités Lignes de forme de transport en sortie. | File |
Modes de transport pour le réseau (Facultatif) | Précise les modes de transport pour lesquels des formes linéaires sont générées sur le réseau routier plutôt que des lignes droites. Des formes pour tous les modes non sélectionnés sont générées à l’aide de lignes droites. Généralement vous devez sélectionner des modes de transport compatibles avec une circulation dans les rues, tels que des bus, puisque ces modes sont représentés le plus précisément par le réseau routier. Ne sélectionnez pas de modes qui ne sont pas modelés par votre réseau routier. Par exemple, sauf si votre réseau modèle explicitement les voies des ferries, n’utilisez pas le réseau pour représenter les chemins parcourus par les ferries. Les modes sont précisés à l’aide des codes dans le tableau ci-dessous. Ils correspondent aux valeurs valides du champ route_type du fichier GTFS routes.txt issues de la documentation GTFS. Les modes 3, 5 et 11 sont utilisés par défaut.
| String |
Source de données réseau (Facultatif) | Jeu de données ou service de réseau qui sera utilisé pour calculer les formes d’itinéraire sur un réseau routier. Vous pouvez utiliser un chemin de catalogue vers un jeu de données de réseau, un objet de couche de jeu de données de réseau, le nom de la chaîne de la couche du jeu de données de réseau ou une URL du portail pour un service d’analyse de réseau. Le réseau doit avoir au minimum un mode de transport. Pour utiliser une URL du portail, vous devez être connecté au portail avec un compte ayant des privilèges de calcul d’itinéraire. L’exécution de l’outil consomme des crédits si vous utilisez ArcGIS Online comme source de données du réseau. En savoir plus sur l’estimation de l’utilisation des crédits pour cet outil Ce paramètre est requis lorsque n’importe quel mode de réseau est sélectionné. Remarque :Le jeu de données du réseau que vous choisissez doit être approprié pour modéliser les véhicules de transport en commun, comme les bus, circulant dans les rues. N’utilisez pas un jeu de données de réseau configuré pour utiliser les données de transport en commun avec l’Évaluateur Transport en commun, car ce type de réseau modélise les passagers qui fréquentent les transports en commun, et non les véhicules de transport en commun qui circulent dans les rues. | Network Data Source |
Mode de déplacement (Facultatif) | Mode de déplacement sur la source de données du réseau à utiliser lors du calcul des formes d’itinéraire sur un réseau routier. Vous pouvez préciser le mode de déplacement comme nom de chaîne du mode de déplacement ou comme objet arcpy.nax.TravelMode. Utilisez le mode de déplacement le plus approprié pour modéliser les véhicules dans votre système de transport en commun sur le réseau routier. Ce paramètre est requis lorsque n’importe quel mode de réseau est sélectionné. Remarque :N’utilisez pas un mode de déplacement avec un attribut d’impédance qui utilise l’Évaluateur Transport en commun, car ce modèle de déplacement modélise les passagers qui circulent sur le transport en commun, et non les véhicules de transport en commun qui circulent dans les rues. | Network Travel Mode |
Côté de la route sur lequel les véhicules circulent (Facultatif) | Précise le côté de la route sur lequel les véhicules circulent dans votre système de transport. Il est utilisé pour veiller à ce que les arrêts soient atteints du bon côté de la route.
| String |
Tolérance de relèvement (Facultatif) | Angle maximal autorisé entre un sens de déplacement estimé d’un véhicule de transport en commun à un arrêt et l’angle du segment du réseau où l’arrêt pourrait se situer. Si les angles affichent un écart supérieur à cette valeur, Network Analyst suppose que ce n’est pas le segment de réseau approprié auquel localiser l’arrêt et continue de chercher d’autres segments de réseau à proximité pour un segment plus approprié. Dans le cadre du calcul des formes d’itinéraire sur un réseau routier, les champs Relèvement et Tolérance de relèvement sont utilisés pour localiser plus précisément les arrêts de transport en commun sur le réseau routier. Le relèvement du véhicule de transport en commun est estimé à chaque arrêt selon les angles entre l’arrêt actuel et les arrêts précédent et suivant sur l’itinéraire de transport. Précisez la valeur en unités de degrés entre 0 et 180. La valeur par défaut est 30. | Double |
Écart maximal de l’angle de relèvement (Facultatif) | Écart maximal autorisé de l’angle de relèvement entre l’arrêt précédent et l’arrêt actuel et entre l’arrêt actuel et l’arrêt suivant. Le relèvement du véhicule de transport en commun est estimé à chaque arrêt selon les angles entre l’arrêt actuel et les arrêts précédent et suivant sur l’itinéraire de transport. Lorsque l’itinéraire de transport suit une route relativement droite, cet angle est une bonne représentation du relèvement. Cependant, si l’itinéraire évite un angle, fait un demi-tour, suit un itinéraire sinueux, ou dévie dans le dépôt d’un parking ou prend une route secondaire, l’angle moyen n’est pas une bonne estimation du relèvement et l’utilisation de cette estimation peut provoquer la localisation de l’arrêt sur le réseau loin de l’endroit où il devrait être et diminue la qualité de la sortie de l’outil. L’outil ignorera l’estimation du relèvement si l’écart de l’angle de l’arrêt précédent au prochain arrêt et de l’arrêt actuel au prochain arrêt est supérieur à la valeur spécifiée dans ce paramètre. Dans ce cas, l’arrêt rétablira le comportement de localisation du réseau normal et effectuera une capture sur le segment le plus proche du réseau non limité. Précisez la valeur en unités de degrés entre 0 et 180. La valeur par défaut est 65. | Double |
Synthèse
Génère une estimation des chemins parcourus par les véhicules dans un système de transport en commun. La sortie de cet outil peut être utilisée pour générer un nouveau fichier shapes.txt pour un jeu de données de transport en commun 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.
Cet outil, ainsi que l’outil Entités vers Formes GTFS, permet de créer un fichier shapes.txt basé sur les informations relatives aux arrêts, itinéraires et horaires à partir d’un jeu de données GTFS existant. Cet outil génère des estimations pour les chemins géographiques utilisés par les véhicules dans le système de transport et écrit la sortie dans une classe d’entités. Vous pouvez examiner et modifier ces entités linéaires avant d’exécuter l’outil Entités vers Formes GTFS qui exporte les formes dans un nouveau fichier shapes.txt.
Cet outil a pour but d’être utilisé dans un workflow se distinguant par trois étapes principales :
- Exécutez cet outil pour produire une estimation des chemins géographiques utilisés par les véhicules dans le système de transport.
- Utilisez la carte pour inspecter chaque forme estimée, et utilisez les outils de modification standard pour effectuer d’éventuelles corrections.
- Exécutez l’outil Entités vers Formes GTFS pour créer un fichier shapes.txt pour votre jeu de données GTFS.
Remarque :
Les outils Formes GTFS vers entités et Générer des entités de forme à partir de GTFS sont utilisés pour différents objectifs. Utilisez Formes GTFS vers entités si votre jeu de données GTFS comporte un fichier shapes.txt existant et que vous voulez convertir ces formes en classe d’entités à afficher sur la carte. Utilisez Générer des entités de forme à partir de GTFS si votre jeu de données GTFS ne comporte pas de fichier shapes.txt existant et que vous voulez estimer les formes en fonction des autres informations contenues dans le jeu de données GTFS et créer un fichier shapes.txt.
Utilisation
Cet outil estime les formes d’itinéraire du réseau de transport en commun à l’aide d’une des options suivantes pour chaque mode de transport dans les données :
- Lignes droites : les formes d’itinéraire de transport correspondent aux lignes droites connectant les arrêts de transport adjacents. Cela est approprié pour les métros, les ferries et les modes de transport autres que sur route.
- Itinéraires de rues générés à l’aide d’un réseau routier : les formes linéaires de transport sont générées en corrigeant un itinéraire entre les arrêts adjacents pour modéliser les véhicules circulant sur les routes d’un réseau.
Pour générer des formes d’itinéraire selon un réseau routier, deux solutions s’offrent à vous :
- Utiliser un jeu de données réseau local : cette option exige de disposer de l’ArcGIS Network Analyst extension ainsi que d’un jeu de données réseau.
- Utiliser un service de portail : cette option exige un compte ArcGIS Online bénéficiant de privilèges de calcul d’itinéraire et de suffisamment de crédits ou un portail sur lequel les services de calcul d’itinéraire ArcGIS Enterprise sont configurés. Vous devez être connecté au portail avant d’exécuter l’outil.
Lors du calcul des formes d’itinéraire sur un réseau routier, Network Analyst risque de ne pas réussir à calculer un itinéraire reliant les arrêts pour certaines formes. En pareils cas, puisque les formes de réseau n’ont pas pu être créées, l’outil crée des formes de ligne droite en lieu et place et renvoie un message d’avertissement indiquant les valeurs shape_id concernées.
Dans le cadre de l’inspection et de la correction de la sortie de l’outil, vous avez la possibilité d’utiliser une requête de définition pour n’afficher qu’une seule forme et ses arrêts associés sur la carte. Utilisez le champ shape_id dans les deux sorties pour sélectionner la forme à afficher. Le champ sequence dans les arrêts en sortie indique l’ordre dans lequel les arrêts de transport en commun sont atteints.
Remarque :
Les entités de forme en sortie créées par cet outil sont une estimation des chemins réels parcourus par les véhicules de transport en commun dans votre système. Inspectez manuellement chaque entité de forme en sortie individuellement pour veiller à ce que le chemin soit approprié.
Avant d’exécuter l’outil Entités vers Formes GTFS, inspectez la sortie des entités de forme à partir de cet outil et apportez d’éventuelles corrections à la géométrie de la forme. Cela garantit la précision de votre fichier final shapes.txt en sortie et permet d’éviter des erreurs lors du calcul du champ shape_dist_traveled pour le fichier stop_times.txt.
En plus d’apporter des corrections de base aux formes afin de représenter précisément les chemins parcourus, modifiez les formes pour éviter que les segments linéaires ne se superposent directement. Si un bus circule dans les deux sens dans une même rue et s’auto-superpose sur l’axe médian, vous pouvez légèrement décaler chaque direction de la ligne de forme d’un côté ou de l’autre de l’axe médian.
Utilisez l’outil de modification Remodeler pour corriger la géométrie de forme. Pour remplacer entièrement la géométrie de forme en numérisant manuellement la forme sur la carte, utilisez l’outil de mise à jour Remplacer la géométrie.
Si les arrêts ne sont pas au bon endroit, utilisez les outils Arrêts GTFS vers Entités et Entités vers Arrêts GTFS pour les corriger, et exécutez à nouveau cet outil.
Lors de l’examen et de la modification des sorties de l’outil, vous pouvez modifier la géométrie des entités et les attributs, mais vous ne pouvez pas supprimer les lignes. Les lignes supprimées peuvent provoquer des erreurs lorsque vous exécutez l’outil Entités vers Formes GTFS.
Paramètres
arcpy.conversion.GenerateShapesFeaturesFromGTFS(in_gtfs_folder, out_shape_lines, out_shape_stops, out_gtfs_trips, {network_modes}, {network_data_source}, {travel_mode}, {drive_side}, {bearing_tolerance}, {max_bearing_angle})| Nom | Explication | Type de données |
in_gtfs_folder | Dossier contenant un jeu de données GTFS valide pour lequel vous souhaitez créer un fichier shapes.txt. Le dossier doit contenir les fichiers GTFS stops.txt, trips.txt,routes.txt et stop_times.txt. | Folder |
out_shape_lines | Classe d’entité linéaire représentant les formes d’itinéraire estimé calculées par cet outil. Chaque ligne de la sortie représente une forme unique requise pour ce jeu de données GTFS. Vous pouvez modifier la géométrie linéaire et utiliser cette classe d’entités comme entrée à l’outil Entités vers Formes GTFS. | Feature Class |
out_shape_stops | Classe d’entités ponctuelles des arrêts de transport GTFS avec un ID les associant à chaque ligne de forme à créer par l’outil. Si le même arrêt GTFS est atteint par plusieurs formes, cette classe d’entités contiendra plusieurs copies de cet arrêt, une pour chaque forme à laquelle il est associé. Cette classe d’entités est utile avec les requêtes de définition lors de la modification d’une ligne de forme à la fois. Utilisez cette classe d’entités comme entrée à l’outil Entités vers Formes GTFS. Remarque :Cette classe d’entités en sortie n’équivaut pas à la sortie de l’outil Arrêts GTFS vers Entités. Cet outil produit une classe d’entités des arrêts GTFS exactement tels qu’ils sont dans le jeu de données d’origine ; il peut produire plusieurs copies de chaque arrêt pour les associer à différentes formes. Utilisez cette classe d’entités en sortie conjointement avec les autres sorties de l’outil Générer des entités de forme à partir de GTFS pour créer un fichier shapes.txt. | Feature Class |
out_gtfs_trips | Fichier GTFS trips.txt en sortie. Ce fichier équivaut au fichier trips.txt dans le dossier GTFS en entrée, mais inclut le champ shape_id ajouté et complété avec les valeurs correspondant au champ shape_id dans la classe d’entités Lignes de forme de transport en sortie. | File |
network_modes [network_modes,...] (Facultatif) | Précise les modes de transport pour lesquels des formes linéaires sont générées sur le réseau routier plutôt que des lignes droites. Des formes pour tous les modes non sélectionnés sont générées à l’aide de lignes droites. Généralement vous devez sélectionner des modes de transport compatibles avec une circulation dans les rues, tels que des bus, puisque ces modes sont représentés le plus précisément par le réseau routier. Ne sélectionnez pas de modes qui ne sont pas modelés par votre réseau routier. Par exemple, sauf si votre réseau modèle explicitement les voies des ferries, n’utilisez pas le réseau pour représenter les chemins parcourus par les ferries. Les modes sont précisés à l’aide des codes dans le tableau ci-dessous. Ils correspondent aux valeurs valides du champ route_type du fichier GTFS routes.txt issues de la documentation GTFS. Les modes 3, 5 et 11 sont utilisés par défaut.
| String |
network_data_source (Facultatif) | Jeu de données ou service de réseau qui sera utilisé pour calculer les formes d’itinéraire sur un réseau routier. Vous pouvez utiliser un chemin de catalogue vers un jeu de données de réseau, un objet de couche de jeu de données de réseau, le nom de la chaîne de la couche du jeu de données de réseau ou une URL du portail pour un service d’analyse de réseau. Le réseau doit avoir au minimum un mode de transport. Pour utiliser une URL du portail, vous devez être connecté au portail avec un compte ayant des privilèges de calcul d’itinéraire. L’exécution de l’outil consomme des crédits si vous utilisez ArcGIS Online comme source de données du réseau. En savoir plus sur l’estimation de l’utilisation des crédits pour cet outil Ce paramètre est requis lorsque n’importe quel mode de réseau est sélectionné. Remarque :Le jeu de données du réseau que vous choisissez doit être approprié pour modéliser les véhicules de transport en commun, comme les bus, circulant dans les rues. N’utilisez pas un jeu de données de réseau configuré pour utiliser les données de transport en commun avec l’Évaluateur Transport en commun, car ce type de réseau modélise les passagers qui fréquentent les transports en commun, et non les véhicules de transport en commun qui circulent dans les rues. | Network Data Source |
travel_mode (Facultatif) | Mode de déplacement sur la source de données du réseau à utiliser lors du calcul des formes d’itinéraire sur un réseau routier. Vous pouvez préciser le mode de déplacement comme nom de chaîne du mode de déplacement ou comme objet arcpy.nax.TravelMode. Utilisez le mode de déplacement le plus approprié pour modéliser les véhicules dans votre système de transport en commun sur le réseau routier. Ce paramètre est requis lorsque n’importe quel mode de réseau est sélectionné. Remarque :N’utilisez pas un mode de déplacement avec un attribut d’impédance qui utilise l’Évaluateur Transport en commun, car ce modèle de déplacement modélise les passagers qui circulent sur le transport en commun, et non les véhicules de transport en commun qui circulent dans les rues. | Network Travel Mode |
drive_side (Facultatif) | Précise le côté de la route sur lequel les véhicules circulent dans votre système de transport. Il est utilisé pour veiller à ce que les arrêts soient atteints du bon côté de la route.
| String |
bearing_tolerance (Facultatif) | Angle maximal autorisé entre un sens de déplacement estimé d’un véhicule de transport en commun à un arrêt et l’angle du segment du réseau où l’arrêt pourrait se situer. Si les angles affichent un écart supérieur à cette valeur, Network Analyst suppose que ce n’est pas le segment de réseau approprié auquel localiser l’arrêt et continue de chercher d’autres segments de réseau à proximité pour un segment plus approprié. Dans le cadre du calcul des formes d’itinéraire sur un réseau routier, les champs Relèvement et Tolérance de relèvement sont utilisés pour localiser plus précisément les arrêts de transport en commun sur le réseau routier. Le relèvement du véhicule de transport en commun est estimé à chaque arrêt selon les angles entre l’arrêt actuel et les arrêts précédent et suivant sur l’itinéraire de transport. Précisez la valeur en unités de degrés entre 0 et 180. La valeur par défaut est 30. | Double |
max_bearing_angle (Facultatif) | Écart maximal autorisé de l’angle de relèvement entre l’arrêt précédent et l’arrêt actuel et entre l’arrêt actuel et l’arrêt suivant. Le relèvement du véhicule de transport en commun est estimé à chaque arrêt selon les angles entre l’arrêt actuel et les arrêts précédent et suivant sur l’itinéraire de transport. Lorsque l’itinéraire de transport suit une route relativement droite, cet angle est une bonne représentation du relèvement. Cependant, si l’itinéraire évite un angle, fait un demi-tour, suit un itinéraire sinueux, ou dévie dans le dépôt d’un parking ou prend une route secondaire, l’angle moyen n’est pas une bonne estimation du relèvement et l’utilisation de cette estimation peut provoquer la localisation de l’arrêt sur le réseau loin de l’endroit où il devrait être et diminue la qualité de la sortie de l’outil. L’outil ignorera l’estimation du relèvement si l’écart de l’angle de l’arrêt précédent au prochain arrêt et de l’arrêt actuel au prochain arrêt est supérieur à la valeur spécifiée dans ce paramètre. Dans ce cas, l’arrêt rétablira le comportement de localisation du réseau normal et effectuera une capture sur le segment le plus proche du réseau non limité. Précisez la valeur en unités de degrés entre 0 et 180. La valeur par défaut est 65. | Double |
Exemple de code
Le script ci-dessous illustre l’utilisation de la fonction GenerateShapesFeaturesFromGTFS dans la fenêtre Python à l’aide d’un jeu de données du réseau local :
arcpy.conversion.GenerateShapesFeaturesFromGTFS(
r"C:\Data\GTFS",
r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
r"C:\Data\GTFSShapes\trips_new.txt",
["3", "5", "11"],
r"C:\Data\NetworkDatasets\Network.gdb\Routing\Routing_ND",
"Bus Driving Time", "Right", 30, 65)Le script ci-dessous montre comment utiliser la fonction GenerateShapesFeaturesFromGTFS dans la fenêtre Python à l’aide des services ArcGIS Online pour générer des formes pour certains modes de transport :
arcpy.transit.GenerateShapesFeaturesFromGTFS(
r"C:\Data\GTFS",
r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
r"C:\Data\GTFSShapes\trips_new.txt",
["0", "3", "5", "11", "OTHER"],
"https://www.arcgis.com/",
"Driving Time", "Right", 30, 65
)Le script suivant démontre comment générer les formes de ligne droite pour tous les modes de transport à l’aide d’une liste vide pour le paramètre network_modes :
arcpy.conversion.GenerateShapesFeaturesFromGTFS(
r"C:\Data\GTFS",
r"C:\Data\GTFSShapes\GTFSShapes.gdb\Shapes",
r"C:\Data\GTFSShapes\GTFSShapes.gdb\Stops",
r"C:\Data\GTFSShapes\trips_new.txt",
[])Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?