交通インシデントの更新(Update Traffic Incidents) (Network Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

Web サービスから取得したライブ交通インシデント データを含むポイント フィーチャクラスを作成します。交通インシデントには、交通事故や道路工事などが含まれます。

使用法

構文

UpdateTrafficIncidents_na (provider, user_name, password, regions, incidents_feature_class_location, incidents_feature_class_name, {time_zone_boundaries}, {time_zone_id_field})
パラメータ説明データ タイプ
provider

交通インシデント データ プロバイダの名前を選択します。このツールでは、次のプロバイダからの交通インシデント データのダウンロードがサポートされます。

  • NAVTEQ:

    • 北米
    • ヨーロッパ
    • 南アメリカ
    • 中東およびアフリカ

  • TomTom:

    • 北米
    • ヨーロッパ

String
user_name

インシデントをダウンロードする際にデータ プロバイダで認証されるユーザ名。データ プロバイダがユーザ名を認証できない場合、ツールの実行は失敗します。

[プロバイダ] パラメータが [TomTom North America] または [TomTom Europe] の場合は、パラメータ値として「APIKEY」を使用します。

String
password

交通インシデント データをダウンロードするデータ プロバイダから提供されたパスワード。データ プロバイダがパスワードを認証できない場合、ツールの実行は失敗します。

Encrypted String
regions
[regions,...]

交通インシデント データをダウンロードする地域を入力します。利用可能な地域をすべてダウンロードする場合は、「#」を入力します。

String
incidents_feature_class_location

出力フィーチャクラスの作成先になる ArcSDE ジオデータベース、ファイル ジオデータベース、またはパーソナル ジオデータベース。このワークスペースはすでに存在している必要があります。

Workspace; Feature Dataset
incidents_feature_class_name

作成するフィーチャクラスの名前。これまでにツールを実行済みで、フィーチャクラスがすでに存在している場合は、既存のフィーチャが削除され、最新のインシデント データに基づいて新しいフィーチャが作成されます。

String
time_zone_boundaries
(オプション)

タイム ゾーンを定義するフィーチャのポリゴン フィーチャクラス。このフィーチャクラスを指定すると、タイム ゾーン境界内で発生しているインシデントを協定世界時ではなく現地時間で報告できます。

タイム ゾーン境界のフィーチャクラスを指定しない場合、インシデントの開始時間と終了時間は UTC(協定世界時)のみで報告され、現地時間のフィールドにはすべて NULL 値が割り当てられます。交通量フィードから得られる特定のインシデント(気象状態など)は、NULL ジオメトリとなる場合があります。このような場合は、タイム ゾーン境界のフィーチャクラスが指定されていても、現地時間フィールドには NULL 値が割り当てられます。

タイム ゾーン境界のフィーチャクラスを指定する場合は、[タイム ゾーンの ID フィールド] プロパティを設定する必要があります。

Feature Layer
time_zone_id_field
(オプション)

Windows のタイム ゾーン識別子を含む、タイム ゾーン境界フィーチャクラスのテキスト フィールド。

このフィールドの値は、Windows レジストリのタイム ゾーンのキーに対応します。「ネットワーク データセットにタイム ゾーンを追加する」の説明と同様の手順に従って、入力フィーチャクラスのポリゴンに対する正しいタイム ゾーン名を確認できます。

Field

コードのサンプル

UpdateTrafficIncidents(交通インシデントの更新)の例 1(Python ウィンドウ)

次の Python ウィンドウ スクリプトは、[交通インシデントの更新(Update Traffic Incidents)] ツールの使用方法を示しています。

import arcpy
arcpy.na.UpdateTrafficIncidents("NAVTEQ North America", "myUserName",
                                "myPassword",
                                ["New England", "New York/Northern NJ/Connecticut"],
                                "C:/Data/Traffic.gdb","Traffic_Incidents",
                                "C:/data/TimeZones.gdb/NATimeZones", "MSTIMEZONE")
UpdateTrafficIncidents(交通インシデントの更新)の例 2(ワークフロー)

次のスタンドアロン Python スクリプトは、[交通インシデントの更新(Update Traffic Incidents)] ツールを使用して、交通インシデントを ArcSDE ジオデータベースにフィーチャクラスとしてダウンロードする方法を示しています。スクリプトを Windows スケジューラ タスクまたは Linux の cron ジョブとして実行し、交通インシデントを定期的に更新することができます。フィーチャクラスは、フィーチャ サービスの公開に使用できます。

# Name: UpdateTrafficIncidents_Workflow.py
# Description: Downloads traffic incidents as a feature class in an ArcSDE
#              geodatabase. The script can be run as a Windows Scheduler Task or
#              a cron job on Linux so that the traffic incidents are updated at 
#              regular intervals. The feature class can be used to publish a 
#              feature service. 

#Import system modules
import arcpy
from arcpy import env


#Set local variables
trafficIncidentsStorage = "C:/data/TrafficIncidentsStorage.sde"
incidentsFeatureClass = "NAVTEQ_NorthAmerica_Incidents"
provider = "NAVTEQ North America"
username = "Replace with your username"
password = "Replace with your password"
#download data for all regions
regions = "#"
timeZoneBoundaries = "C:/data/TimeZones.gdb/NATimeZones"
timeZonesID = "MSTIMEZONE"

try:
    #Update Traffic Data. Use default values for remaining parameters
    arcpy.na.UpdateTrafficIncidents(provider,username,password, regions,
                                    trafficIncidentsStorage, incidentsFeatureClass,
                                    timeZoneBoundaries, timeZonesID)

    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: ○
5/10/2014