Generar entidades de formas a partir de GTFS (Transporte público)

Resumen

Genera una estimación de las rutas recorridas por los vehículos en un sistema de transporte público. La salida de esta herramienta se puede utilizar para generar un nuevo archivo shapes.txt para un dataset de transporte público 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 Entidades a formas GTFS, permite crear un archivo shapes.txt basado en la información sobre paradas, rutas y horarios procedente de un dataset GTFS existente. Esta herramienta genera buenas estimaciones para las rutas geográficas utilizadas por los vehículos del sistema de transporte y escribe la salida en una clase de entidad. Puede revisar y editar estas entidades de línea antes de ejecutar la herramienta Entidades a formas GTFS, que exporta las formas a un nuevo archivo shapes.txt.

Esta herramienta está pensada para usarse en un flujo de trabajo con tres pasos principales:

  1. Ejecute esta herramienta para producir una buena estimación de las rutas geográficas utilizadas por los vehículos del sistema de transporte.
  2. Use el mapa para inspeccionar cada forma estimada y use las herramientas de edición estándar para realizar las correcciones necesarias.
  3. Ejecute la herramienta Entidades a formas GTFS para crear un archivo shapes.txt para el dataset GTFS.

Nota:

Las herramientas Formas GTFS a entidades y Generar entidades de forma a partir de GTFS se utilizan para fines diferentes. Utilice Formas GTFS a entidades si el dataset GTFS incluye un archivo shapes.txt existente y desea convertir estas formas en una clase de entidad para mostrar en el mapa. Utilice Generar entidades de forma a partir de GTFS si el dataset GTFS no incluye ningún archivo shapes.txt existente y desea evaluar las formas en función de otra información contenida en el dataset GTFS, además de crear un archivo shapes.txt.

Uso

  • Esta herramienta realiza una estimación de las formas de ruta de la red de transporte público utilizando una de las siguientes opciones para cada modo de transporte de los datos:

    • Líneas rectas: las formas de las rutas de transporte son líneas rectas que conectan paradas de transporte adyacentes. Esto es apropiado para metros, ferris u otros modos de transporte que no recorren las calles.
    • Rutas en la calle generadas usando una red de carreteras: las formas de las líneas de transporte se generan al resolver una ruta entre paradas adyacentes para modelar los vehículos que recorren las carreteras de una red.
    Se puede elegir qué opción usar para cada modo de transporte público incluido en los datos. Por ejemplo, puede crear formas para las líneas de autobús que utilicen la red y líneas rectas para los trenes subterráneos. Se configura en el parámetro Modos de transporte para la red.

    Existen dos opciones para generar formas de ruta basadas en una red de carreteras:

    • Utilizar un dataset de red local: esta opción requiere disponer de la ArcGIS Network Analyst extension y de un dataset de red.
    • Utilizar un servicio de portal: esta opción requiere una cuenta de ArcGIS Online con privilegios de generación de rutas y con créditos suficientes o un portal con los ArcGIS Enterprise routing services configurados. Debe iniciar sesión en el portal antes de ejecutar la herramienta.

  • Al calcular formas de ruta a lo largo de una red de carreteras, Network Analyst puede no calcular correctamente una ruta que conecte las paradas de algunas formas. En estos casos, dado que no se pudieron crear formas de red, la herramienta crea formas de línea recta en su lugar y devuelve un mensaje de advertencia que indica qué valores de shape_id se vieron afectados.

  • Al inspeccionar y corregir la salida de la herramienta, puede usar una consulta de definición para mostrar en el mapa una sola forma y sus paradas asociadas. Use el campo shape_id en ambas salidas para seleccionar la forma a mostrar. El campo sequence en las paradas de salida indica el orden en que se visitan las paradas de transporte.

  • Nota:

    Las entidades de forma de salida creadas con esta herramienta son una estimación de las rutas reales recorridas por los vehículos de transporte del sistema. Inspeccione manualmente cada entidad de forma de salida para asegurarse de que la ruta sea correcta.

    Antes de ejecutar la herramienta Entidades a formas GTFS, inspeccione cuidadosamente la salida de la entidad de forma de esta herramienta y realice las correcciones necesarias en la geometría de la forma. Garantiza que su archivo shapes.txt de salida final sea preciso y ayuda a evitar errores en el cálculo del campo shape_dist_traveled para el archivo stop_times.txt.

    Además de realizar correcciones básicas a las formas para representar con precisión las rutas recorridas, edite sus formas para evitar la superposición directa de segmentos de línea. 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.

    Use la herramienta de edición Cambiar de forma para corregir la geometría de la forma. Si desea reemplazar completamente la geometría de la forma digitalizando manualmente la forma en el mapa, use la herramienta de edición Reemplazar geometría.

    Si sus paradas no están en la ubicación correcta, use las herramientas Paradas GTFS a entidades y Entidades a paradas GTFS para corregirlas y vuelva a ejecutar esta herramienta.

  • Al examinar y editar las salidas de la herramienta puede editar la geometría y los atributos de la entidad, pero no eliminar filas. La eliminación de filas puede causar errores al ejecutar la herramienta Entidades a formas GTFS.

Parámetros

EtiquetaExplicaciónTipo de datos
Carpeta GTFS de entrada

Carpeta que contiene el dataset GTFS válido para el que desea crear un archivo shapes.txt. La carpeta debe contener los archivos GTFS stops.txt, trips.txt, routes.txt y stop_times.txt.

Folder
Líneas de forma de transporte de salida

Clase de entidad de línea que representa las formas de ruta estimadas calculadas por esta herramienta. Cada línea de la salida representa una forma única requerida para este dataset GTFS. Puede editar la geometría de la línea y utilizar esta clase de entidad como entrada para la herramienta Entidades a formas GTFS.

Feature Class
Paradas de forma de salida

Clase de entidad de puntos de las paradas de transporte GTFS con un Id. que los asocia con cada línea de forma que va a crear la herramienta. En los casos en que varias formas visitan la misma parada GTFS, esta clase de entidad contendrá varias copias de esa parada, una para cada forma con la que está asociada. Esta clase de entidad es útil con consultas de definición al editar las líneas de forma de una en una. Use esta clase de entidad como entrada para la herramienta Entidades a formas GTFS.

Nota:

Esta clase de entidad de salida no es equivalente a la salida de la herramienta Paradas GTFS a entidades. Esa herramienta genera una clase de entidad de sus paradas GTFS exactamente como están en el dataset original, mientras que esta herramienta puede generar varias copias de cada parada para asociarlas con diferentes formas. Esta clase de entidad de salida está diseñada para usarse solo junto con las otras salidas de la herramienta Generar entidades de formas a partir de GTFS para crear un archivo shapes.txt.

Feature Class
Viajes GTFS de salida

El archivo GTFS trips.txt de salida. Este archivo será equivalente al archivo trips.txt de la carpeta GTFS de entrada, pero incluye el campo shape_id agregado y rellenado con los valores correspondientes al campo shape_id de la clase de entidad Líneas de forma de transporte de salida.

File
Modos de transporte para la red
(Opcional)

Especifica los modos de transporte para los que se generarán formas de línea a lo largo de la red de carreteras en lugar de líneas rectas. Las formas de todos los modos no seleccionados se generarán usando líneas rectas.

Por lo general, debe seleccionar los modos que se ejecutan en las calles, como los autobuses, ya que esos modos están representados con la mayor precisión por la red de carreteras. No seleccione modos que no estén modelados por su red de carreteras. Por ejemplo, a menos que su red modele explícitamente las rutas de los ferris, no use la red para representar los caminos recorridos por los ferris.

Los modos se especifican utilizando los códigos de la tabla siguiente. Estos corresponden a los valores route_type del GTFS routes.txt válido de la Documentación GTFS.

De forma predeterminada, se utilizan los modos 3, 5 y 11.

  • Tranvía y metro ligero (GTFS 0)Tranvía y metro ligero. Este modo corresponde a un route_type de GTFS de 0.
  • Suburbano y metro (GTFS 1)Subterráneo o metro. Este modo corresponde a un route_type de GTFS de 1.
  • Ferrocarril (GTFS 2)Ferrocarril. Este modo corresponde a un route_type de GTFS de 2.
  • Autobús (GTFS 3)Autobús. Este modo corresponde a un route_type de GTFS de 3.
  • Ferri (GTFS 4)Ferri. Este modo corresponde a un route_type de GTFS de 4.
  • Tranvía de cable (GTFS 5)Tranvía de cable. Este modo corresponde a un route_type de GTFS de 5.
  • Telecabina, teleférico suspendido y tranvía aéreo (GTFS 6)Telecabina, teleférico suspendido y tranvía aéreo. Este modo corresponde a un route_type de GTFS de 6.
  • Funicular (GTFS 7)Funicular. Este modo corresponde a un route_type de GTFS de 7.
  • Trolebús (GTFS 11)Trolebús. Este modo corresponde a un route_type de GTFS de 11.
  • Monorraíl (GTFS 12)Monorraíl. Este modo corresponde a un route_type de GTFS de 12.
  • Otro modo de transporteCualquier modo de transporte público no incluido en las otras opciones.
String
Fuente de datos de red
(Opcional)

El dataset o servicio de red a utilizar para calcular las formas de ruta a lo largo de una red de carreteras. Puede usar una ruta de catálogo a un dataset de red, un objeto de capa de dataset de red, el nombre de la cadena de caracteres de la capa del dataset de red o una URL de portal para un servicio de análisis de red. La red debe tener como mínimo un modo de viaje.

Para usar una URL de portal, debe iniciar sesión en el portal con una cuenta que tenga privilegios de generación de rutas.

La ejecución de la herramienta consumirá créditos si usa ArcGIS Online como fuente de datos de red.

Más información sobre cómo estimar el uso de créditos para esta herramienta

Este parámetro es obligatorio cuando se selecciona cualquier modo de red.

Nota:

El dataset de red que elija debe ser apropiado para modelar vehículos de transporte, como autobuses, que circulen por las calles. No use un dataset de red configurado para usar datos de transporte público con el evaluador de Transporte público, porque este tipo de red modela a los pasajeros que viajan en transporte público, no a los vehículos de transporte público que circulan por las calles.

Network Data Source
Modo de viaje
(Opcional)

El modo de viaje de la fuente de datos de red que se usará al calcular formas de ruta a lo largo de una red de carreteras. Puede especificar el modo de viaje como un nombre de cadena de caracteres del modo de viaje o como un objeto arcpy.nax.TravelMode.

Use el modo de viaje más apropiado para modelar los vehículos de su sistema de transporte que circulan a lo largo de la red de carreteras.

Este parámetro es obligatorio cuando se selecciona cualquier modo de red.

Nota:

No use un modo de viaje con un atributo de impedancia que use el evaluador de Transporte público, porque ese modo de viaje modela a los pasajeros que viajan en transporte público, no a los vehículos de transporte que circulan por las calles.

Network Travel Mode
Lado de la carretera en el que circulan los vehículos
(Opcional)

Especifica el lado de la carretera en el que circulan los vehículos en su sistema de transporte. Esto se utiliza para garantizar que las paradas se realicen en el lado correcto de la carretera.

  • IzquierdaLos vehículos circulan por el lado izquierdo de la carretera.
  • DerechaLos vehículos circulan por el lado derecho de la carretera. Esta es la opción predeterminada.
String
Tolerancia de rumbo
(Opcional)

Al calcular las formas de las rutas de una red de carreteras, el rumbo y la tolerancia de rumbo se utilizan para localizar con mayor precisión las paradas de transporte a lo largo de la red de carreteras. El rumbo del vehículo de transporte se estima en cada parada en función de los ángulos entre la parada actual y las paradas anteriores y siguientes a lo largo de la ruta de transporte.

El valor especificado en este parámetro indica el ángulo máximo permitido entre la dirección de viaje estimada de un vehículo de transporte en una parada y el ángulo del eje de red en el que la parada podría ubicarse. Si los ángulos difieren más que este valor, Network Analyst asume que este no es el eje de red correcto para ubicar la parada y continúa buscando otros ejes de red cercanos para encontrar uno más apropiado.

Especifique el valor en unidades de grados entre 0 y 180. El valor predeterminado es 30.

Double
Diferencia máxima de ángulo de rumbo
(Opcional)

El rumbo del vehículo de transporte se estima en cada parada en función de los ángulos entre la parada actual y las paradas anteriores y siguientes a lo largo de la ruta de transporte. Cuando la ruta de transporte sigue un camino relativamente recto, este ángulo es una buena representación del rumbo. Sin embargo, si la ruta gira en una esquina, hace un cambio de sentido, sigue una carretera sinuosa o se desvía hacia un aparcamiento o una carretera lateral, el ángulo promedio no es una buena estimación del rumbo real y el uso de esta estimación puede causar que la parada a ubicar en la red quede lejos de donde debería estar y se empeore la calidad de la salida de la herramienta.

La herramienta ignora la estimación de rumbo si la diferencia de ángulo de la parada anterior a la parada actual y de la parada actual a la siguiente parada es mayor que el valor especificado en este parámetro. En esta situación, la parada volverá al comportamiento normal de ubicación en la red y se ajustará al eje de red no restringido más cercano.

Especifique el valor en unidades de grados entre 0 y 180. El valor predeterminado es 65.

Double

arcpy.transit.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})
NombreExplicaciónTipo de datos
in_gtfs_folder

Carpeta que contiene el dataset GTFS válido para el que desea crear un archivo shapes.txt. La carpeta debe contener los archivos GTFS stops.txt, trips.txt, routes.txt y stop_times.txt.

Folder
out_shape_lines

Clase de entidad de línea que representa las formas de ruta estimadas calculadas por esta herramienta. Cada línea de la salida representa una forma única requerida para este dataset GTFS. Puede editar la geometría de la línea y utilizar esta clase de entidad como entrada para la herramienta Entidades a formas GTFS.

Feature Class
out_shape_stops

Clase de entidad de puntos de las paradas de transporte GTFS con un Id. que los asocia con cada línea de forma que va a crear la herramienta. En los casos en que varias formas visitan la misma parada GTFS, esta clase de entidad contendrá varias copias de esa parada, una para cada forma con la que está asociada. Esta clase de entidad es útil con consultas de definición al editar las líneas de forma de una en una. Use esta clase de entidad como entrada para la herramienta Entidades a formas GTFS.

Nota:

Esta clase de entidad de salida no es equivalente a la salida de la herramienta Paradas GTFS a entidades. Esa herramienta genera una clase de entidad de sus paradas GTFS exactamente como están en el dataset original, mientras que esta herramienta puede generar varias copias de cada parada para asociarlas con diferentes formas. Esta clase de entidad de salida está diseñada para usarse solo junto con las otras salidas de la herramienta Generar entidades de formas a partir de GTFS para crear un archivo shapes.txt.

Feature Class
out_gtfs_trips

El archivo GTFS trips.txt de salida. Este archivo será equivalente al archivo trips.txt de la carpeta GTFS de entrada, pero incluye el campo shape_id agregado y rellenado con los valores correspondientes al campo shape_id de la clase de entidad Líneas de forma de transporte de salida.

File
network_modes
[network_modes,...]
(Opcional)

Especifica los modos de transporte para los que se generarán formas de línea a lo largo de la red de carreteras en lugar de líneas rectas. Las formas de todos los modos no seleccionados se generarán usando líneas rectas.

Por lo general, debe seleccionar los modos que se ejecutan en las calles, como los autobuses, ya que esos modos están representados con la mayor precisión por la red de carreteras. No seleccione modos que no estén modelados por su red de carreteras. Por ejemplo, a menos que su red modele explícitamente las rutas de los ferris, no use la red para representar los caminos recorridos por los ferris.

Los modos se especifican utilizando los códigos de la tabla siguiente. Estos corresponden a los valores route_type del GTFS routes.txt válido de la Documentación GTFS.

De forma predeterminada, se utilizan los modos 3, 5 y 11.

  • 0Tranvía y metro ligero. Este modo corresponde a un route_type de GTFS de 0.
  • 1Subterráneo o metro. Este modo corresponde a un route_type de GTFS de 1.
  • 2Ferrocarril. Este modo corresponde a un route_type de GTFS de 2.
  • 3Autobús. Este modo corresponde a un route_type de GTFS de 3.
  • 4Ferri. Este modo corresponde a un route_type de GTFS de 4.
  • 5Tranvía de cable. Este modo corresponde a un route_type de GTFS de 5.
  • 6Telecabina, teleférico suspendido y tranvía aéreo. Este modo corresponde a un route_type de GTFS de 6.
  • 7Funicular. Este modo corresponde a un route_type de GTFS de 7.
  • 11Trolebús. Este modo corresponde a un route_type de GTFS de 11.
  • 12Monorraíl. Este modo corresponde a un route_type de GTFS de 12.
  • OTHERCualquier modo de transporte público no incluido en las otras opciones.
String
network_data_source
(Opcional)

El dataset o servicio de red a utilizar para calcular las formas de ruta a lo largo de una red de carreteras. Puede usar una ruta de catálogo a un dataset de red, un objeto de capa de dataset de red, el nombre de la cadena de caracteres de la capa del dataset de red o una URL de portal para un servicio de análisis de red. La red debe tener como mínimo un modo de viaje.

Para usar una URL de portal, debe iniciar sesión en el portal con una cuenta que tenga privilegios de generación de rutas.

La ejecución de la herramienta consumirá créditos si usa ArcGIS Online como fuente de datos de red.

Más información sobre cómo estimar el uso de créditos para esta herramienta

Este parámetro es obligatorio cuando se selecciona cualquier modo de red.

Nota:

El dataset de red que elija debe ser apropiado para modelar vehículos de transporte, como autobuses, que circulen por las calles. No use un dataset de red configurado para usar datos de transporte público con el evaluador de Transporte público, porque este tipo de red modela a los pasajeros que viajan en transporte público, no a los vehículos de transporte público que circulan por las calles.

Network Data Source
travel_mode
(Opcional)

El modo de viaje de la fuente de datos de red que se usará al calcular formas de ruta a lo largo de una red de carreteras. Puede especificar el modo de viaje como un nombre de cadena de caracteres del modo de viaje o como un objeto arcpy.nax.TravelMode.

Use el modo de viaje más apropiado para modelar los vehículos de su sistema de transporte que circulan a lo largo de la red de carreteras.

Este parámetro es obligatorio cuando se selecciona cualquier modo de red.

Nota:

No use un modo de viaje con un atributo de impedancia que use el evaluador de Transporte público, porque ese modo de viaje modela a los pasajeros que viajan en transporte público, no a los vehículos de transporte que circulan por las calles.

Network Travel Mode
drive_side
(Opcional)

Especifica el lado de la carretera en el que circulan los vehículos en su sistema de transporte. Esto se utiliza para garantizar que las paradas se realicen en el lado correcto de la carretera.

  • LEFTLos vehículos circulan por el lado izquierdo de la carretera.
  • RIGHTLos vehículos circulan por el lado derecho de la carretera. Esta es la opción predeterminada.
String
bearing_tolerance
(Opcional)

Al calcular las formas de las rutas de una red de carreteras, el rumbo y la tolerancia de rumbo se utilizan para localizar con mayor precisión las paradas de transporte a lo largo de la red de carreteras. El rumbo del vehículo de transporte se estima en cada parada en función de los ángulos entre la parada actual y las paradas anteriores y siguientes a lo largo de la ruta de transporte.

El valor especificado en este parámetro indica el ángulo máximo permitido entre la dirección de viaje estimada de un vehículo de transporte en una parada y el ángulo del eje de red en el que la parada podría ubicarse. Si los ángulos difieren más que este valor, Network Analyst asume que este no es el eje de red correcto para ubicar la parada y continúa buscando otros ejes de red cercanos para encontrar uno más apropiado.

Especifique el valor en unidades de grados entre 0 y 180. El valor predeterminado es 30.

Double
max_bearing_angle
(Opcional)

El rumbo del vehículo de transporte se estima en cada parada en función de los ángulos entre la parada actual y las paradas anteriores y siguientes a lo largo de la ruta de transporte. Cuando la ruta de transporte sigue un camino relativamente recto, este ángulo es una buena representación del rumbo. Sin embargo, si la ruta gira en una esquina, hace un cambio de sentido, sigue una carretera sinuosa o se desvía hacia un aparcamiento o una carretera lateral, el ángulo promedio no es una buena estimación del rumbo real y el uso de esta estimación puede causar que la parada a ubicar en la red quede lejos de donde debería estar y se empeore la calidad de la salida de la herramienta.

La herramienta ignora la estimación de rumbo si la diferencia de ángulo de la parada anterior a la parada actual y de la parada actual a la siguiente parada es mayor que el valor especificado en este parámetro. En esta situación, la parada volverá al comportamiento normal de ubicación en la red y se ajustará al eje de red no restringido más cercano.

Especifique el valor en unidades de grados entre 0 y 180. El valor predeterminado es 65.

Double

Muestra de código

Ejemplo 1 de GenerateShapesFeaturesFromGTFS (ventana de Python)

El siguiente script muestra cómo utilizar la función GenerateShapesFeaturesFromGTFS en la ventana de Python usando un dataset de red local:

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",
    ["3", "5", "11"],
    r"C:\Data\NetworkDatasets\Network.gdb\Routing\Routing_ND",
    "Bus Driving Time", "Right", 30, 65
)
Ejemplo 2 de GenerateShapesFeaturesFromGTFS (ventana de Python)

El siguiente script muestra cómo utilizar la función GenerateShapesFeaturesFromGTFS en la ventana de Python usando los servicios de ArcGIS Online para generar formas para algunos modos de transporte:

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
)
Ejemplo 3 de GenerateShapesFeaturesFromGTFS (ventana de Python)

El siguiente script muestra cómo generar formas de línea recta para todos los modos de transporte utilizando una lista vacía para el parámetro network_modes:

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",
    []
)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados