要素转 GTFS 形状 (转换)

摘要

基于根据 GTFS 生成形状要素工具创建的路线制图表达,为 GTFS 公共交通数据集创建 shapes.txt 文件。

可选 GTFS shapes.txt 文件包含交通系统中交通车辆所采用地理路径的制图表达。 要在地图上正确显示公交路线,一个较好的 shapes.txt 文件对于基于 GTFS 的路径选择应用程序非常重要。 虽然许多交通机构都会使用其车辆上的 GPS 追踪器来生成其 shapes.txt 文件,但是其他缺少此硬件的交通机构可能无法创建此文件。

将此工具与根据 GTFS 生成形状要素工具配合使用,可以基于现有 GTFS 数据集中的停靠点、路径和计划信息表创建 shapes.txt 文件。 运行根据 GTFS 生成形状要素工具以评估交通系统中车辆所行驶的路径并根据本地知识对结果进行微调后,可以运行此工具将这些线要素转换到新的 shapes.txt 文件中。 此工具还会创建一个新的 GTFS stop_times.txt 文件,其中 shape_dist_traveled 字段填充了与新形状相对应的值。

使用情况

  • 此工具的大部分输入应为根据 GTFS 生成形状要素工具的输出。 这两个工具通常配合使用。

  • GTFS stop_times.txt 文件中的 shape_dist_traveled 字段将指示特定停靠点沿交通线路的距离。 例如,如果公共汽车沿路径行驶 1.5 英里到达第五个停靠点,则该停靠点的 shape_dist_traveled 值为 1.5。 对于沿该路径的每个停靠点,shape_dist_traveled 字段应增大。 例如,行驶到第五个停靠点的距离应大于行驶到第四个停靠点的距离,并且应小于行驶到第六个停靠点的距离。

    要素转 GTFS 形状工具将使用线性参考过程来计算停靠点的 shape_dist_traveled 字段值。 在某些情况下,针对沿路径的顺序停靠点计算的值可能不会增大。 该工具将产生一条警告消息,指示出现此问题的形状(如果存在)。 当输入形状的线几何与自身重叠或者包含环时,通常会出现此问题。 因此,在运行此工具之前,必须仔细查看并编辑形状线,以确保形状线尽可能干净和正确。 如果公共汽车沿同一街道在两个方向上行驶并且在中心线上与自身重叠,则有助于将形状线的每个方向稍微偏移到中心线的任一侧。

参数

标注说明数据类型
输入形状线

一个线要素类,表示通过运行根据 GTFS 生成形状要素工具创建的 GTFS形状。 该要素类必须包含 shape_id 字段,其中值对应于其他工具输入中的 shape_id 字段值。

Feature Layer
输入形状停靠点

一个点要素类,表示与通过运行根据 GTFS 生成形状要素工具创建的每个形状相关联的 GTFS 停靠点。 如果多个形状使用交通停靠点,则应在此要素类中针对使用该停靠点的每个形状复制该停靠点。

该要素类必须包含 shape_id 字段,其中值对应于其他工具输入中的 shape_id 字段值。 它还必须包含 stop_id 字段,其中值对应于输入 GTFS stop_times.txt 文件中 shape_id 列的值。

Feature Layer
输入更新后的 GTFS 行程

通过运行根据 GTFS 生成形状要素工具创建的更新后的 GTFS trips.txt 文件。 该文件必须具有 shape_id 列,其值对应于其他工具输入中 shape_id 字段的值。

File
输入 GTFS 停靠时间

运行根据 GTFS 生成形状要素工具时使用的 GTFS 数据集中的原始 stop_times.txt 文件。

File
输出 GTFS 形状

输出 GTFS shapes.txt 文件。

File
输出 GTFS 停靠时间

输出 GTFS stop_times.txt 文件,此文件将包含 shape_dist_traveled 字段,其中值源自新形状。

File
距离单位
(可选)

指定在填充输出 GTFS 文件中的 shape_dist_traveled 字段时要使用的距离单位。

  • 英里单位为英里。 这是默认设置。
  • 单位为米
  • 千米单位为千米
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})
名称说明数据类型
in_shape_lines

一个线要素类,表示通过运行根据 GTFS 生成形状要素工具创建的 GTFS形状。 该要素类必须包含 shape_id 字段,其中值对应于其他工具输入中的 shape_id 字段值。

Feature Layer
in_shape_stops

一个点要素类,表示与通过运行根据 GTFS 生成形状要素工具创建的每个形状相关联的 GTFS 停靠点。 如果多个形状使用交通停靠点,则应在此要素类中针对使用该停靠点的每个形状复制该停靠点。

该要素类必须包含 shape_id 字段,其中值对应于其他工具输入中的 shape_id 字段值。 它还必须包含 stop_id 字段,其中值对应于输入 GTFS stop_times.txt 文件中 shape_id 列的值。

Feature Layer
in_gtfs_trips

通过运行根据 GTFS 生成形状要素工具创建的更新后的 GTFS trips.txt 文件。 该文件必须具有 shape_id 列,其值对应于其他工具输入中 shape_id 字段的值。

File
in_gtfs_stop_times

运行根据 GTFS 生成形状要素工具时使用的 GTFS 数据集中的原始 stop_times.txt 文件。

File
out_gtfs_shapes

输出 GTFS shapes.txt 文件。

File
out_gtfs_stop_times

输出 GTFS stop_times.txt 文件,此文件将包含 shape_dist_traveled 字段,其中值源自新形状。

File
distance_units
(可选)

指定在填充输出 GTFS 文件中的 shape_dist_traveled 字段时要使用的距离单位。

  • MILES单位为英里。 这是默认设置。
  • METERS单位为米
  • KILOMETERS单位为千米
String

代码示例

FeaturesToGTFSShapes 示例 1(Python 窗口)

此脚本显示如何在 Python 窗口中运行 FeaturesToGTFSShapes 函数。

旧版本:

此工具已移至 ArcGIS Pro 2.9 处的公共交通工具工具箱中。 代码示例中的语法使用与工具的新位置相关联的 transit 工具箱别名。 但是,conversion 工具箱别名继续工作。 您不需要修改现有脚本,但您应该为新脚本使用 transit 别名。

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

环境

特殊情况

随机数生成器

仅使用此环境变量的种子部分。 将忽略生成器类型。

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是