更新交通数据 (Network Analyst)

许可等级:BasicStandardAdvanced

摘要

从 Web 服务下载实时交通数据并将其存储在动态交通格式 (DTF) 文件中,该文件可供网络数据集读取,并用来进行实时交通分析和显示。

用法

语法

UpdateTrafficData_na (provider, user_name, password, regions, traffic_data_output_folder, expected_update_interval, prediction_cutoff, compress_data, {maximum_file_age})
参数说明数据类型
provider

选择交通数据提供商的名称。该工具支持从以下提供商下载交通数据:

  • NAVTEQ

    • 北美洲
    • 欧洲
    • 南美洲
    • 大洋洲
    • 中东 & 非洲
    • 印度
    • 东南亚

  • TomTom

    • 北美洲
    • 欧洲

  • INRIX

    • 加利福尼亚州

String
user_name

经数据提供商授权可下载交通数据的用户名。如果数据提供商无法鉴别用户名,则无法执行该工具。

如果“提供商”参数为“北美 TomTom”或“欧洲 TomTom”,则使用 "APIKEY" 作为参数值。

String
password

数据提供商所提供的用于下载交通数据的密码。如果数据提供商无法鉴别密码,则无法执行该工具。

Encrypted String
regions
[regions,...]

输入要下载交通数据的区域。如果要下载所有可用区域,请输入 "#"

String
traffic_data_output_folder

要创建 DTF 文件的文件夹。如果文件夹为空,则该工具将随 DTF 文件创建 TrafficIndex.xml 文件。为运行后续工具,该工具将更新 TrafficIndex.xml 并创建 DTF 文件。

如果从多个数据提供商下载数据,应为每个数据提供商指定唯一的文件夹。

Folder
expected_update_interval

以分钟为单位的时间间隔,在此时间间隔之后,下载的交通数据不再是最新数据,数据提供商将提供更新的数据。此时间间隔过后,建议您重新运行该工具并下载最新的数据。

Long
prediction_cutoff

此工具处理预测性交通数据的时间间隔(分钟)。数据提供商可以提供第二天或其他时间段的预测性数据。此时间段值用于限制工具处理预测性交通数据的数量,从而加快工具执行速度。

Long
compress_data
  • COMPRESS下载 TrafficIndex.xml 和 DTF 文件,然后在压缩文件夹中创建 DTF 文件的副本。如果网络数据集要通过地理处理服务连接到实时交通数据,则使用此选项;向客户端传输 DTF 文件的压缩文件夹比传输 DTF 文件本身更快。
  • NO_COMPRESS下载 TrafficIndex.xml 和 DTF 文件,而不在压缩文件夹中创建其副本。如果网络数据集要通过文件夹连接来连接到实时交通数据,则使用此选项。这是默认值。
Boolean
maximum_file_age
(可选)

交通文件(即 DTF 文件)在交通数据输出文件夹中保存的时间间隔(分钟)。此参数有助于快速删除不再需要的交通文件。重新运行该工具时,将自动删除所有超过最长文件保留期限的交通数据文件。默认值为 720 分钟(12 小时)。

Long

代码实例

UpdateTrafficData 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何使用“更新交通数据”工具。

import arcpy
arcpy.na.UpdateTrafficData("NAVTEQ North America", "myUserName", "myPassword",
                           ["New England", "New York/Northern NJ/Connecticut"],
                           "d:/data/dtfs", 15, 120,"NO_COMPRESS", 720)
UpdateTrafficData 示例 2(工作流)

以下独立 Python 脚本演示了如何使用“更新交通数据”工具从提供商下载实时交通数据。可将该脚本作为“Windows 任务调度程序”或 cron 作业 (Linux) 运行,从而按固定时间间隔更新实时交通数据。

# Name: UpdateTrafficData_Workflow.py
# Description: Downloads live traffic data from a provider. The script can be run
#              as a Windows Scheduler Task or a cron job on Linux so that the 
#              live traffic data is updated at regular intervals. 

#Import system modules
import arcpy

#Set local variables
trafficDataFolder = "C:/data/TrafficData"
provider = "NAVTEQ North America"
username = "Replace with your username"
password = "Replace with your password"
#download data for all regions
regions = "#"

try:
    #Update Traffic Data. Use default values for remaining parameters
    arcpy.na.UpdateTrafficData(provider,username,password, regions,
                               trafficDataFolder)

    print "Script completed successfully."

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print "An error occured on line %i" % tb.tb_lineno
    print str(e)

环境

此工具不使用任何地理处理环境

相关主题

许可信息

ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013