“配置网络数据集实时流量”实用程序允许您配置网络数据集以使用来自 ArcGIS Online 的实时流量数据。 使用实时流量配置网络数据集后,可以基于此网络数据集发布路径服务。
在运行该实用程序之前,您应该具备以下条件:
- 能够与基于 TMC 或 OpenLR 的实时流量配合使用的网络数据集。
了解有关如何设置实时流量先决条件的详细信息。
- 适用于 ArcGIS Online 订阅的实时流量扩展模块。
要启用实时流量扩展模块,请联系 Esri 客户服务中心。
参数
可以使用以下参数运行“配置网络数据集实时流量”实用程序:
参数 | 细节 |
---|---|
-u | 用于从 ArcGIS Online 获取实时流量数据的 ArcGIS Online 账户的用户名。 此账户的 ArcGIS Online 订阅应获得实时流量扩展模块的许可。 |
-p | 指定使用 -u 参数的用户的密码。 |
-n | 网络数据集的完整路径。 如果网络数据集位于文件地理数据库中,则 -n 选项应包括文件地理数据库的路径、网络数据集的名称以及包含网络数据集的要素数据集的名称。 例如:此选项的值可以为 Windows 上的 c:\data\Streets.gdb\Routing\Routing_ND 以及 Linux 上的 /data/Streets.gdb/Routing/Routing_ND,其中 Streets.gdb 为文件地理数据库,该地理数据库在名为 Routing 的要素数据集中具有名为 Routing_ND 的网络数据集。 如果网络数据集位于移动地图包中,则 -n 选项应包括从提取移动地图包的文件夹到 SQLite 数据库的路径、网络数据集的名称以及包含网络数据集的要素数据集的名称。 例如:此选项的值可以为 Windows 上的 c:\street_data\p30\northamerica.geodatabase\Routing\Routing_ND 以及 Linux 上的 /data/street_data/p30/northamerica.geodatabase/Routing/Routing_ND,其中 northamerica.geodatabase 为 SQLite 地理数据库,该地理数据库在名为 Routing 的要素数据集中具有名为 Routing_ND 的网络数据集。 |
-r | 获取实时流量数据的区域名称。 有效选项为 NorthAmerica、LatinAmerica、Europe、MiddleEastAndAfrica 和 AsiaPacific。 |
-t | 要在网络数据集上配置的实时流量类型。 有效选项为 OpenLR 和 TMC。 默认值为 OpenLR。 |
-l | 当配置基于 OpenLR 的实时流量时,用于存储流量缓存文件的现有文件夹的路径。 如果未指定,则将使用系统默认文件夹。 提示:系统默认值可能不在计算机中的快速存储上。 为了获得最佳性能,建议指定为此选项值的路径位于计算机中的快速存储上,例如 SSD 驱动器。 |
-h | 打印该实用程序的帮助。 |
警告:
该工具用于修改输入网络数据集并在包含网络数据集的地理数据库的文件夹中创建文件。 应随网络数据集一起复制具有扩展名 .traffic 和 .ags 的文件,以便实时流量功能正常运行。 例如,在多机 ArcGIS Server 站点上发布路径服务之前,请确保将已修改的网络数据集和输出文件复制到站点中的每台计算机上。
示例
以下示例显示了如何在 ArcGIS Server 站点上调用“配置网络数据集实时流量”实用程序。
警告:
如果实用程序支持的任何参数的值都使用 @ 字符,例如使用 -p 选项指定的密码,则无法在命令行上指定参数值。 相反,您应该将参数保存在文件中并从文件传递参数。
可以使用 OpenLR 实时流量配置存储在文件地理数据库中的北美洲网络数据集。 实时流量数据设置为下载到名为 /data/traffic-cache 的现有文件夹中。 示例假设 ArcGIS Server 安装位置为 /arcgis/server。
/arcgis/server/tools/python3 /arcgis/server/framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices/configure_smp_live_traffic.py -u username -p secret -n /data/NorthAmerica.gdb/Routing/Routing_ND -r NorthAmerica -t OpenLR -l /data/traffic-cache
可以通过从文件中传递参数来调用实用程序。 如果运行实用程序作为自动化进程的一部分,或者不希望在命令行中键入所有选项,则此参数非常有用。 要从文件中指定参数,请创建一个文本文件,然后在新行中指定每个选项。 应使用 = 符号分隔参数名称和值。 具有各种选项的示例文件如下所示。
-u=username
-p=secret
-n=/data/NorthAmerica.gdb/Routing/Routing_ND
-r=NorthAmerica
-t=OpenLR
-l=/data/traffic-cache
要使用以上 tool-params.txt 文件调用工具,请调用工具并使用 @ 符号指定文件路径。
警告:
确保带参数的文件没有任何额外的新行或空格。
/arcgis/server/tools/python3 /arcgis/server/framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices/configure_smp_live_traffic.py @/data/tool-params.txt