Entidades a formas GTFS (Conversión)

Resumen

Crea un archivo shapes.txt para un dataset de transporte público GTFS basado en las representaciones de línea de ruta creadas con la herramienta Generar entidades de formas a partir de GTFS.

El archivo GTFS shapes.txt opcional contiene una representación de las rutas geográficas tomadas por los vehículos de transporte en un sistema de transporte. Un buen archivo shapes.txt es importante para que las aplicaciones de generación de rutas basadas en GTFS muestren correctamente las rutas de transporte en el mapa. Aunque muchas agencias de transporte generan sus archivos shapes.txt utilizando rastreadores GPS en sus vehículos, algunas agencias de transporte que carecen de este hardware pueden tener problemas para crear este archivo.

Esta herramienta, junto con la herramienta Generar entidades de formas a partir de GTFS, permite crear un archivo shapes.txt basado en la información sobre paradas, rutas y horarios procedente de un dataset GTFS existente. Tras ejecutar la herramienta Generar entidades de formas a partir de GTFS para estimar las rutas recorridas por los vehículos del sistema de transporte y ajustar los resultados en función del conocimiento local, puede ejecutar esta herramienta para convertir esas entidades de línea en un nuevo archivo shapes.txt. La herramienta también crea un nuevo archivo GTFS stop_times.txt con el campo shape_dist_traveled rellenado con los valores correspondientes a las nuevas formas.

Uso

  • La mayoría de las entradas a esta herramienta deben ser las salidas de la herramienta Generar entidades de formas a partir de GTFS. Estas dos herramientas se han diseñado para ser utilizadas juntas.

  • El campo shape_dist_traveled del archivo GTFS stop_times.txt indica lo lejos que se encuentra una parada concreta a lo largo de una línea de transporte. Por ejemplo, si un autobús conduce 1,5 kilómetros para llegar a la quinta parada de una ruta, el valor de shape_dist_traveled de esa parada es 1,5. El campo shape_dist_traveled debería aumentar con cada parada de la ruta. La distancia recorrida hasta la quinta parada debería ser mayor que la distancia recorrida hasta la cuarta parada y menor que la recorrida hasta la sexta parada, por ejemplo.

    La herramienta Entidades a formas GTFS utiliza un procedimiento de referenciación lineal para calcular los valores del campo shape_dist_traveled para las paradas. En algunos casos, los valores calculados para las paradas secuenciales de una ruta pueden no estar aumentando. La herramienta generará un mensaje de advertencia que indica qué formas, si las hay, tienen este problema. Este problema generalmente ocurre cuando la geometría de línea de la forma de entrada se superpone a sí misma o contiene bucles. En consecuencia, es importante revisar y editar cuidadosamente las líneas de forma antes de ejecutar esta herramienta, para asegurarse de que estén tan limpias y correctas como sea posible. Si un autobús viaja en ambas direcciones a lo largo de la misma calle y se superpone en la línea central, puede ayudar desplazar ligeramente cada dirección de la línea de forma a cada lado de la línea central.

Parámetros

EtiquetaExplicaciónTipo de datos
Líneas de forma de entrada

Una clase de entidad de línea que representa las formas GTFS creadas al ejecutar la herramienta Generar entidades de formas a partir de GTFS. La clase de entidad debe contener un campo shape_id con los valores correspondientes a los valores del campo shape_id en las otras entradas de la herramienta.

Feature Layer
Paradas de forma de entrada

Una clase de entidad de punto que representa las paradas GTFS asociadas con cada forma creada al ejecutar la herramienta Generar entidades de formas a partir de GTFS. Si varias formas usan una parada de transporte, la parada se debe duplicar en esta clase de entidad para cada forma que la use.

La clase de entidad debe contener un campo shape_id con los valores correspondientes a los valores del campo shape_id en las otras entradas de la herramienta. También debe contener un campo stop_id con los valores correspondientes a los de la columna shape_id del archivo stop_times.txt GTFS de entrada.

Feature Layer
Viajes GTFS actualizados de entrada

El archivo GTFS trips.txt actualizado creado al ejecutar la herramienta Generar entidades de formas a partir de GTFS. Este archivo debe tener la columna shape_id con los valores correspondientes a los de los campos shape_id en las otras entradas de herramienta.

File
Tiempos de parada GTFS de entrada

El archivo stop_times.txt original procedente del dataset GTFS utilizado al ejecutar la herramienta Generar entidades de formas a partir de GTFS.

File
Formas GTFS de salida

El archivo GTFS shapes.txt de salida.

File
Tiempos de parada GTFS de salida

El archivo GTFS stop_times.txt de salida que contiene el campo shape_dist_traveled con los valores derivados de las nuevas formas.

File
Unidades de distancia
(Opcional)

Especifica las unidades de distancia que usar al rellenar el campo shape_dist_traveled en los archivos GTFS de salida.

  • MillasLa unidad está en millas. Esta es la opción predeterminada.
  • MetrosLa unidad está en metros
  • KilómetrosLa unidad está en kilómetros
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})
NombreExplicaciónTipo de datos
in_shape_lines

Una clase de entidad de línea que representa las formas GTFS creadas al ejecutar la herramienta Generar entidades de formas a partir de GTFS. La clase de entidad debe contener un campo shape_id con los valores correspondientes a los valores del campo shape_id en las otras entradas de la herramienta.

Feature Layer
in_shape_stops

Una clase de entidad de punto que representa las paradas GTFS asociadas con cada forma creada al ejecutar la herramienta Generar entidades de formas a partir de GTFS. Si varias formas usan una parada de transporte, la parada se debe duplicar en esta clase de entidad para cada forma que la use.

La clase de entidad debe contener un campo shape_id con los valores correspondientes a los valores del campo shape_id en las otras entradas de la herramienta. También debe contener un campo stop_id con los valores correspondientes a los de la columna shape_id del archivo stop_times.txt GTFS de entrada.

Feature Layer
in_gtfs_trips

El archivo GTFS trips.txt actualizado creado al ejecutar la herramienta Generar entidades de formas a partir de GTFS. Este archivo debe tener la columna shape_id con los valores correspondientes a los de los campos shape_id en las otras entradas de herramienta.

File
in_gtfs_stop_times

El archivo stop_times.txt original procedente del dataset GTFS utilizado al ejecutar la herramienta Generar entidades de formas a partir de GTFS.

File
out_gtfs_shapes

El archivo GTFS shapes.txt de salida.

File
out_gtfs_stop_times

El archivo GTFS stop_times.txt de salida que contiene el campo shape_dist_traveled con los valores derivados de las nuevas formas.

File
distance_units
(Opcional)

Especifica las unidades de distancia que usar al rellenar el campo shape_dist_traveled en los archivos GTFS de salida.

  • MILESLa unidad está en millas. Esta es la opción predeterminada.
  • METERSLa unidad está en metros
  • KILOMETERSLa unidad está en kilómetros
String

Muestra de código

Ejemplo 1 de FeaturesToGTFSShapes (ventana de Python)

Este script muestra cómo ejecutar la herramienta FeaturesToGTFSShapes en la ventana de Python.

Heredado:

Esta herramienta se movió a la caja de herramientas Herramientas de Tránsporte público en ArcGIS Pro 2.9. La sintaxis de la muestra de código utiliza el alias de la caja de herramientas transit asociado a la nueva ubicación de la herramienta. Sin embargo, el alias de la caja de herramientas conversion sigue funcionando. No es necesario que modifique los scripts existentes, pero debe utilizar el alias transit para los nuevos scripts.

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

Entornos

Casos especiales

Generador de números aleatorios

Solo se utiliza la parte de valor de inicialización de esta variable de entorno. Se ignora el tipo de generador.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí