Zusammenfassung
Generiert eine Schätzung der von den Fahrzeugen in einem öffentlichen Verkehrssystem verwendeten Strecken. Mit der Ausgabe dieses Werkzeugs kann eine neue Datei shapes.txt für ein GTFS-Dataset mit öffentlichen Verkehrsmitteln generiert werden.
Die optionale GTFS-Datei shapes.txt enthält eine Darstellung der von Verkehrsmitteln in einem öffentlichen Verkehrssystem verwendeten Strecken. GTFS-basierte Routenführungs-Apps benötigen eine ordnungsgemäße Datei shapes.txt für die korrekte Darstellung von Verkehrswegen auf der Karte. Viele Verkehrsbetriebe generieren mithilfe der GPS-Tacker in ihren Fahrzeugen eine eigene shapes.txt-Datei. Für andere Verkehrsbetriebe, die nicht über diese Hardware verfügen, ist diese Datei jedoch möglicherweise schwierig zu erstellen.
Sie können mit diesem Werkzeug in Kombination mit dem Werkzeug Features in GTFS-Shapes die Datei shapes.txt auf Grundlage der Informationen zu Haltestellen, Routen und Zeitplänen aus einem vorhandenen GTFS-Dataset erstellen. Dieses Werkzeug generiert eine gute Schätzung der von Fahrzeugen im öffentlichen Verkehrssystem verwendeten Strecken und schreibt die Ausgabe in eine Feature-Class. Sie können diese Linien-Features überprüfen und bearbeiten, bevor Sie das Werkzeug Features in GTFS-Shapes ausführen, das die Shapes in eine neue Datei shapes.txt exportiert.
Dieses Werkzeug ist für die Verwendung in einem Workflow vorgesehen, der aus drei Hauptschritten besteht:
- Führen Sie dieses Werkzeug aus, um eine gute Schätzung der von Fahrzeugen im öffentlichen Verkehrssystem verwendeten Strecken zu erzeugen.
- Verwenden Sie die Karte, um jedes geschätzte Shape zu überprüfen, und führen Sie mit den Standard-Editierwerkzeugen ggf. erforderliche Änderungen durch.
- Führen Sie das Werkzeug Features in GTFS-Shapes aus, um die Datei shapes.txt für das GTFS-Dataset zu erstellen.
Hinweis:
Das Werkzeug GTFS-Shapes in Features und das Werkzeug Shape-Features aus GTFS generieren werden für unterschiedliche Zwecke verwendet. Verwenden Sie GTFS-Shapes in Features, wenn in Ihrem GTFS-Dataset bereits eine shapes.txt-Datei vorhanden ist und Sie diese Shapes in eine Feature-Class konvertieren möchten, um sie in der Karte anzuzeigen. Verwenden Sie Shape-Features aus GTFS generieren, wenn in Ihrem GTFS-Dataset keine shapes.txt-Datei vorhanden ist und Sie die Shapes basierend auf den sonstigen im GTFS-Dataset enthaltenen Informationen schätzen sowie eine shapes.txt-Datei erstellen möchten.
Verwendung
Dieses Werkzeug schätzt die Routen-Shapes des öffentlichen Verkehrsnetzes mit einer der folgenden Optionen für die einzelnen Arten des öffentlichen Verkehrs in den Daten:
- Gerade Linien: Die Routen-Shapes des öffentlichen Verkehrs sind gerade Linien zwischen benachbarten Haltestellen des öffentlichen Verkehrs. Diese Option eignet sich für U-Bahnen, Fähren und andere Arten des öffentlichen Verkehrs, die keine Straßen nutzen.
- Mit einem Straßennetz generierte Straßenrouten: Shapes für Linien des öffentlichen Verkehrs werden durch Ermitteln einer Route zwischen benachbarten Haltestellen generiert, um die Wege von Fahrzeugen auf Straßen in einem Straßennetz zu modellieren.
Für das Generieren von Routen-Shapes auf Grundlage eines Straßennetzes gibt es zwei Optionen:
- Lokales Netzwerk-Dataset verwenden: Für diese Option müssen Sie über die Erweiterung "ArcGIS Network Analyst" und ein Netzwerk-Dataset verfügen.
- Portal-Service verwenden: Diese Option erfordert ein ArcGIS Online-Konto mit Routing-Berechtigungen und eine ausreichende Anzahl von Credits oder ein Portal mit konfigurierten ArcGIS Enterprise routing services. Vor dem Ausführen des Werkzeugs müssen Sie beim Portal angemeldet sein.
Beim Berechnen der Routen-Shapes in einem Straßennetz kann Network Analyst möglicherweise die Route zwischen den Haltestellen für einige Shapes nicht erfolgreich berechnen. Da in diesen Fällen keine Netzwerk-Shapes erstellt werden konnten, erstellt das Werkzeug stattdessen auf geraden Linien basierende Shapes und gibt eine Warnmeldung aus, in der die betroffenen shape_id-Werte angegeben werden.
Wenn Sie die Ausgabe des Werkzeugs überprüfen und korrigieren, können Sie eine Definitionsabfrage verwenden, um nur ein einzelnes Shape und die zugehörigen Haltestellen auf der Karte anzuzeigen. Wählen Sie mittels des Feldes shape_id in beiden Ausgaben das Shape aus, das angezeigt werden soll. Das Feld sequence in den Haltestellen der Ausgabe gibt die Reihenfolge an, in der die Haltestellen angefahren werden.
Hinweis:
Die von diesem Werkzeug erstellten Ausgabe-Shape-Features sind eine Schätzung der tatsächlich von den öffentlichen Verkehrsmitteln im System verwendeten Strecken. Überprüfen Sie jedes einzelne Ausgabe-Shape-Feature manuell, um sicherzustellen, dass die Strecke korrekt ist.
Überprüfen Sie vor dem Ausführen des Werkzeugs Features in GTFS-Shapes sorgfältig die Shape-Feature-Ausgabe dieses Werkzeugs, und nehmen Sie ggf. erforderliche Korrekturen an der Shape-Geometrie vor. So stellen Sie sicher, dass die endgültige Ausgabedatei shapes.txt korrekt ist, und Sie können Fehler bei der Berechnung des Feldes shape_dist_traveled für die Datei stop_times.txt vermeiden.
Nehmen Sie nicht nur grundlegende Korrekturen an den Shapes vor, damit die verwendeten Strecken korrekt dargestellt werden, sondern bearbeiten Sie auch die Shapes, damit sich Liniensegmente nicht direkt überlappen. Wenn ein Bus auf derselben Straße in beide Richtungen fährt und sich auf der Mittelachse selbst überlappt, ist es möglicherweise hilfreich, jede Richtung der Shape-Linie auf jeder Seite der Mittelachse geringfügig zu verschieben.
Verwenden Sie zum Korrigieren der Shape-Geometrie das Editierwerkzeug Umformen. Wenn Sie die Shape-Geometrie vollständig ersetzen möchten, indem Sie das Shape in der Karte manuell digitalisieren, verwenden Sie das Editierwerkzeug Geometrie ersetzen.
Wenn sich die Haltestellen an einer falschen Position befinden, korrigieren Sie sie mit den Werkzeugen GTFS-Stopps in Features und Features in GTFS-Stopps, und führen Sie dieses Werkzeug erneut aus.
Beim Überprüfen und Bearbeiten der Werkzeugausgaben können Sie die Feature-Geometrie und -Attribute bearbeiten. Löschen Sie jedoch keine Zeilen. Gelöschte Zeilen können beim Ausführen des Werkzeugs Features in GTFS-Shapes Fehler verursachen.
Syntax
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})| Parameter | Erklärung | Datentyp |
in_gtfs_folder | Ein Ordner, der ein gültiges GTFS-Dataset enthält, für das Sie die Datei shapes.txt erstellen möchten. Der Ordner muss die GTFS-Dateien stops.txt, trips.txt, routes.txt und stop_times.txt enthalten. | Folder |
out_shape_lines | Eine Line-Feature-Class, die die mit diesem Werkzeug berechneten geschätzten Routen-Shapes darstellt. Jede Linie in der Ausgabe stellt ein eindeutiges Shape dar, das für dieses GTFS-Dataset erforderlich ist. Sie können die Liniengeometrie bearbeiten und diese Feature-Class als Eingabe für das Werkzeug Features in GTFS-Shapes verwenden. | Feature Class |
out_shape_stops | Eine Point-Feature-Class von GTFS-Stopps mit einer ID, die sie mit den einzelnen Shape-Linien verknüpft, die von dem Werkzeug erstellt werden. Wenn ein GTFS-Stopp von mehreren Shapes verwendet wird, enthält diese Feature-Class mehrere Kopien dieses Stopps, und zwar für jedes verknüpfte Shape eine Kopie. Diese Feature-Class ist bei Definitionsabfragen hilfreich, wenn Shape-Linien einzeln nacheinander bearbeitet werden. Verwenden Sie diese Feature-Class als Eingabe für das Werkzeug Features in GTFS-Shapes. Hinweis:Diese Ausgabe-Feature-Class entspricht nicht der Ausgabe des Werkzeugs GTFS-Stopps in Features. Letzteres Werkzeug erzeugt eine Feature-Class der GTFS-Stopps, die genau mit dem ursprünglichen Dataset übereinstimmen. Dieses Werkzeug hingegen erzeugt ggf. mehrere Kopien jedes Stopps, um sie mit unterschiedlichen Shapes zu verknüpfen. Diese Ausgabe-Feature-Class sollte nur gemeinsam mit anderen Ausgaben des Werkzeugs Shape-Features aus GTFS generieren zum Erstellen der Datei shapes.txt verwendet werden. | Feature Class |
out_gtfs_trips | Die Ausgabe-GTFS-Datei trips.txt. Diese Datei entspricht der Datei trips.txt im GTFS-Eingabeordner. Sie enthält jedoch das zusätzliche Feld shape_id, dessen Werte dem Feld shape_id in der Feature-Class Ausgabe-Shape-Linien des öffentlichen Verkehrs entsprechen. | File |
network_modes [network_modes,...] (optional) | Gibt die Arten des öffentlichen Verkehrs an, für die Linien-Shapes auf Grundlage des Straßennetzes statt mit geraden Linien generiert werden. Die Shapes für alle nicht ausgewählten Arten des öffentlichen Verkehrs werden mit geraden Linien generiert. Sie sollten in der Regel Arten des öffentlichen Verkehrs wählen, für die Straßen genutzt werden, z. B. Busse, da diese Verkehrsarten durch das Straßennetz am genauesten dargestellt werden. Wählen Sie keine Arten des öffentlichen Verkehrs, die nicht durch das Straßennetz modelliert werden. Verwenden Sie beispielsweise das Netzwerk nicht zum Darstellen der Strecken von Fähren, es sei denn, Fährstrecken werden vom Netzwerk explizit modelliert. Die Arten des öffentlichen Verkehrs werden mit den Codes in der folgenden Tabelle angegeben. Diese entsprechen den gültigen GTFS-route_type-Werten routes.txt aus der GTFS-Dokumentation. Die Arten des öffentlichen Verkehrs 3, 5 und 11 werden standardmäßig verwendet.
| String |
network_data_source (optional) | Das Netzwerk-Dataset oder der Netzwerk-Service, mit dem die Routen-Shapes im Straßennetz berechnet werden. Sie können einen Katalogpfad zu einem Netzwerk-Dataset, ein Netzwerk-Dataset-Layer-Objekt, den Zeichenfolgennamen des Netzwerk-Dataset-Layers oder eine Portal-URL für einen Netzwerkanalyse-Service verwenden. Das Netzwerk muss über mindestens einen Reisemodus verfügen. Um eine Portal-URL zu verwenden, müssen Sie mit einem Konto, das über Routing-Berechtigungen verfügt, beim Portal angemeldet sein. Durch das Ausführen des Werkzeugs werden Credits verbraucht, wenn Sie ArcGIS Online als Netzwerkdatenquelle verwenden. Weitere Informationen zum Schätzen des Credit-Verbrauchs für dieses Werkzeug Dieser Parameter ist bei Auswahl von Netzwerkmodi erforderlich. Hinweis:Das von Ihnen gewählte Netzwerk-Dataset sollte zum Modellieren von öffentlichen Verkehrsmitteln, die auf Straßen fahren, z. B. Bussen, geeignet sein. Verwenden Sie kein Netzwerk-Dataset, das für die Verwendung von Daten des öffentlichen Verkehrs mit dem Evaluator "Öffentlicher Verkehr" konfiguriert ist, da dieser Netzwerktyp Fahrgäste des öffentlichen Verkehrs und nicht öffentliche Verkehrsmittel auf Straßen modelliert. | Network Data Source |
travel_mode (optional) | Der Reisemodus in der Netzwerkdatenquelle, der beim Berechnen von Routen-Shapes in einem Straßennetz verwendet werden soll. Sie können den Reisemodus als Zeichenfolgenname des Reisemodus oder als arcpy.nax.TravelMode-Objekt angeben. Verwenden Sie den Reisemodus, der sich am besten zum Modellieren von öffentlichen Verkehrsmitteln im Straßennetz eignet. Dieser Parameter ist bei Auswahl von Netzwerkmodi erforderlich. Hinweis:Verwenden Sie keinen Reisemodus mit einem Impedanzattribut, das den Evaluator "Öffentlicher Verkehr" verwendet, da dieser Reisemodus Fahrgäste des öffentlichen Verkehrs und nicht öffentliche Verkehrsmittel auf Straßen modelliert. | Network Travel Mode |
drive_side (optional) | Gibt die Seite der Straße an, auf der die Fahrzeuge im öffentlichen Verkehrssystem fahren. Mit dieser Option wird sichergestellt, dass Haltestellen auf der richtigen Seite der Straße angefahren werden.
| String |
bearing_tolerance (optional) | Beim Berechnen der Routen-Shapes in einem Straßennetz werden Peilung und Peilungstoleranz für die genauere Verortung von Haltestellen des öffentlichen Verkehrs im Straßennetz verwendet. Die Peilung des öffentlichen Verkehrsmittels wird auf Grundlage der Winkel zwischen der aktuellen Haltestelle und der vorherigen und nächsten Haltestelle der öffentlichen Verkehrsroute geschätzt. Der Wert dieses Parameters gibt den maximal zulässigen Winkel zwischen der geschätzten Fahrtrichtung eines öffentlichen Verkehrsmittels an einer Haltestelle und dem Winkel der Netzwerkkante an, an dem die Haltestelle verortet werden kann. Wenn die Winkel um mehr als diesen Wert abweichen, bestimmt Network Analyst, dass es sich nicht um die richtige Netzwerkkante zum Verorten der Haltestelle handelt, und durchsucht andere Netzwerkkanten in der Nähe, um eine besser geeignete zu finden. Geben Sie einen Wert zwischen 0 und 180 Grad an. Der Standardwert ist 30. | Double |
max_bearing_angle (optional) | Die Peilung des öffentlichen Verkehrsmittels wird auf Grundlage der Winkel zwischen der aktuellen Haltestelle und der vorherigen und nächsten Haltestelle der öffentlichen Verkehrsroute geschätzt. Wenn die öffentliche Verkehrsroute auf einer relativ geraden Straße verläuft, ist dieser Winkel eine gute Darstellung der Peilung. Wenn die Route jedoch um eine Ecke verläuft, eine Wende um 180 Grad aufweist, auf einer kurvenreichen Straße verläuft oder auf einen Parkplatz oder in eine Seitenstraße abzweigt, ist der durchschnittliche Winkel keine gute Schätzung der tatsächlichen Peilung. Die Verwendung dieser Schätzung kann bewirken, dass die Haltestelle weit entfernt von der korrekten Haltestelle im Netzwerk verortet und die Qualität der Werkzeugausgabe gemindert wird. Das Werkzeug ignoriert die Peilungsschätzung, wenn die Differenz zwischen dem Winkel der vorherigen Haltestelle und der aktuellen Haltestelle sowie zwischen dem Winkel der aktuellen Haltestelle und der nächsten Haltestelle größer als der Wert dieses Parameters ist. In dieser Situation wird auf die Haltestelle das normale Netzwerkverortungsverhalten angewendet, und sie wird an der nächstgelegenen nicht eingeschränkten Netzwerkkante gefangen. Geben Sie einen Wert zwischen 0 und 180 Grad an. Der Standardwert ist 65. | Double |
Codebeispiel
Das folgende Skript veranschaulicht, wie im Python-Fenster die Funktion GenerateShapesFeaturesFromGTFS mit einem lokalen Netzwerk-Dataset verwendet wird:
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)Das folgende Skript veranschaulicht, wie im Python-Fenster die Funktion GenerateShapesFeaturesFromGTFS mit den ArcGIS Online-Services verwendet wird, um Shapes für einige Arten des öffentlichen Verkehrs zu generieren:
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",
["0", "3", "5", "11", "OTHER"],
"https://www.arcgis.com/",
"Driving Time", "Right", 30, 65)Das folgende Skript veranschaulicht, wie mit einer leeren Liste für den Parameter network_modes auf geraden Linien basierende Shapes für alle Arten des öffentlichen Verkehrs generiert werden:
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",
[])Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja