交通量データの更新(Update Traffic Data) (Network Analyst)
サマリ
ライブ交通量データを Web サービスからダウンロードして DTF(動的交通量フォーマット)ファイルに格納します。ネットワーク データセットは、このファイルをライブ交通量解析で読み取って表示できます。
使用法
-
このツールを使用して交通量データをダウンロードするには、[プロバイダ] パラメータに指定したデータ プロバイダのいずれかでアカウントを取得しておく必要があります。
このツールを定期的または指定した時間に実行するようにスケジュール設定することで、利用する交通量データが最新であることを保証できます。一般的な方法としては、Windows のタスク スケジューラを使用して、このツールを呼び出す Python スクリプトを実行します。
構文
パラメータ | 説明 | データ タイプ |
provider |
交通量データ プロバイダの名前を選択します。このツールでは、次のプロバイダからの交通量データのダウンロードがサポートされます。
| String |
user_name |
交通量データをダウンロードする際にデータ プロバイダで認証されるユーザ名。データ プロバイダがユーザ名を認証できない場合、ツールの実行は失敗します。 [プロバイダ] パラメータが [TomTom North America] または [TomTom Europe] の場合は、パラメータ値として「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 |
| Boolean |
maximum_file_age (オプション) |
交通量ファイル(DTF ファイル)を交通量データ出力フォルダに保存する期間(分単位)。このパラメータを利用すると、不要になった交通量ファイルを簡単に削除できます。ツールを再実行したときに、ファイルの最大保存期間よりも古くなった交通量データ ファイルは自動的に削除されます。デフォルト値は 720 分(12 時間)です。 | Long |
コードのサンプル
次の Python ウィンドウ スクリプトは、[交通量データの更新(Update Traffic Data)] ツールの使用方法を示しています。
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)
次のスタンドアロン Python スクリプトは、[交通量データの更新(Update Traffic Data)] ツールを使用して、ライブ交通量データをプロバイダからダウンロードする方法を示しています。スクリプトを Windows スケジューラ タスクまたは Linux の cron ジョブとして実行し、ライブ交通量データを定期的に更新することができます。
# 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)