RouteSolverProperties (arcpy.na)

サマリ

ルート ネットワーク解析レイヤの解析プロパティにアクセスできます。GetSolverProperties 関数を使用して、ルート ネットワーク解析レイヤから RouteSolverProperties オブジェクトを取得できます。

説明

RouteSolverProperties オブジェクトを利用すると、ルート ネットワーク解析レイヤのすべての解析プロパティに読み取りおよび書き込みアクセスが可能です。オブジェクトを使用してルート レイヤの必要な解析プロパティを変更し、対応するレイヤを再解析して適切な結果を得ることができます。新しいルート レイヤは、[ルート レイヤの作成（Make Route Layer）] ジオプロセシング ツールを使用して作成できます。新しいルート レイヤから RouteSolverProperties オブジェクトを取得すると、以降の解析で既存のレイヤを再利用できます。解析ごとに新しいレイヤを作成する必要がないため、解析速度の低下がありません。

RouteSolverProperties オブジェクトのプロパティを変更した後、対応するレイヤはすぐに他の関数やジオプロセシング ツールと一緒に使用できるようになります。レイヤを更新して、オブジェクトを通して変更された内容を反映する必要はありません。

特性

プロパティ	説明	データ タイプ
accumulators (読み書き)	解析時に累積されるネットワーク コスト属性のリストを取得または設定できます。空のリスト（[]）は、累積されるコスト属性がないことを表します。	String
attributeParameters (読み書き)	解析で使用されるパラメータ化属性を取得または設定できます。プロパティは Python ディクショナリを返します。ディクショナリのキーは、属性名とパラメータで構成される 2 つの値の組み合わせです。ディクショナリ内の各アイテムの値はパラメータ値です。 パラメータ化されたネットワーク属性は、リアルタイムに変化する属性値をモデリングするために使用されます。たとえば、12 フィートの車高規制があるトンネルをパラメータを使用してモデリングできます。この場合、車両の高さ（フィート）をパラメータ値として指定する必要があります。車両の高さが 12 フィートを超えている場合は、この規制が true に評価され、トンネルの通行が規制されます。同様に、橋は重量規制を指定するパラメータを保持することができます。 attributeParameters プロパティを直接変更しようとしても、値は更新されません。常に新しいディクショナリ オブジェクトを使用して、プロパティの値を設定する必要があります。以下の 2 つのコード ブロックは、これらの 2 つの方法の違いを示しています。 #Don't attempt to modify the attributeParameters property in place. #This coding method won't work. solverProps.attributeParameters[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED" #Modify the attributeParameters property using a new dictionary object. #This coding method works. params = solverProps.attributeParameters params[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED" solverProps.attributeParameters = params ネットワーク解析レイヤにパラメータ化属性がない場合、このプロパティは None を返します。	Dictionary
findBestSequence (読み書き)	Controls whether the stops are reordered to find optimal routes. The following is a list of possible values: FIND_BEST_ORDER —The stops will be reordered to find the optimal route. This option changes the route analysis from a shortest-path problem to a traveling salesperson problem (TSP). A value of True can also be used to specify this option. USE_INPUT_ORDER —The stops will be visited in the input order. A value of False can also be used to specify this option.	String
impedance (読み書き)	Provides the ability to get or set the network cost attribute used as impedance. This cost attribute is minimized while determining the best route.	String
orderingType (読み書き)	Controls the ordering of stops when findBestSequence property is set to FIND_BEST_ORDER. The following is a list of possible values: PRESERVE_BOTH —Preserves the first and last stops by input order as the first and last stops in the route. PRESERVE_FIRST —Preserves the first stop by input order as the first stop in the route, but the last stop is free to be reordered. PRESERVE_LAST —Preserves the last stop by input order as the last stop in the route, but the first stop is free to be reordered. PRESERVE_NONE —Frees both the first and last stop to be reordered.	String
outputPathShape (読み書き)	Provides the ability to get or set the shape type for the route features that are output by the solver. The following is a list of possible values: TRUE_LINES_WITH_MEASURES —The output routes will have the exact shape of the underlying network sources. Furthermore, the output includes route measurements for linear referencing. The measurements increase from the first stop and record the cumulative impedance to reach a given position. TRUE_LINES_WITHOUT_MEASURES —The output routes will have the exact shape of the underlying network sources. STRAIGHT_LINES —The output route shape will be a single straight line between the stops. NO_LINES —No shape will be generated for the output routes.	String
restrictions (読み書き)	解析時に適用される規制属性のリストを取得または設定できます。空のリスト（[]）は、解析で使用される規制属性がないことを表します。	String
solverName (読み取り専用)	Returns the name of the solver being referenced by the network analysis layer used to obtain the solver properties object. The property always returns the string value Route Solver when accessed from a RouteSolverProperties object.	String
timeOfDay (読み書き)	Provides the ability to get or set the start date and time for the route. Route start time is mostly used to find routes based on the impedance attribute that varies with the time of the day. For example, a start time of 9 a.m. could be used to find a route that considers the rush-hour traffic. A value of None can be used to specify that no date and time should be used. Instead of using a particular date, a day of the week can be specified using the following dates: 今日 - 1899/12/30 日 - 1899/12/31 月 - 1900/1/1 火 - 1900/1/2 水 - 1900/1/3 木 - 19001/4 金 - 1900/1/5 土 - 1900/1/6 For example, to specify that the route should start at 5:00 p.m. on Tuesday, specify the value as datetime.datetime(1900, 1, 2, 17,0,0). The timeZoneUsage parameter specifies whether the date and time refer to UTC or the time zone in which the first stop is located.	DateTime
timeZoneUsage (読み書き)	Specifies the time zone of the timeOfDay parameter. GEO_LOCAL —The timeOfDay parameter refers to the time zone in which the first stop is located. UTC —The timeOfDay parameter refers to Coordinated Universal Time (UTC). Choose this option if you want to solve the analysis for a specific time, such as now, but aren't certain in which time zone the facilities or demand points will be located. When solving a route analysis that spans across multiple time zones and setting a start time, the orderingType cannot be set to PRESERVE_NONE. A starting location and time zone must be fixed.	String
uTurns (読み書き)	ストップ間のネットワーク移動中に発生する可能性のあるジャンクションでの U ターンを、解析でどのように処理するかを指定するポリシーを取得または設定できます。設定可能な値の一覧を次に示します。 ALLOW_UTURNS（U ターンを許可） —任意の数の接続されたエッジを持つジャンクションで U ターンを許可します。 NO_UTURNS（U ターンを規制） —ジャンクションの結合にかかわらず、すべてのジャンクションで U ターンを禁止します。ただし、この設定が選択されている場合でも、ネットワーク ロケーションでは U ターンが許可されます。同様に、個々のネットワーク ロケーションの CurbApproach プロパティで U ターンを禁止するように設定できます。 ALLOW_DEAD_ENDS_ONLY（行き止まりのみ許可） —1 つの隣接エッジを持つジャンクション（行き止まり）を除くすべてのジャンクションでの U ターンを禁止します。 ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —2 つの隣接するエッジが接するジャンクションでの U ターンを禁止します。ただし、交差点（3 つ以上の隣接エッジを持つジャンクション）および行き止まり（1 つの隣接エッジを持つジャンクション）では U ターンを許可します。ネットワークには、道路セグメントの中間に無関係のジャンクションが存在する場合があります。このオプションは、これらの場所で車両が U ターンすることを防ぎます。	String
useHierarchy (読み書き)	解析を実行しているときの階層属性の使用を制御します。設定可能な値の一覧を次に示します。 USE_HIERARCHY（階層を使用） — 階層属性を解析に使用します。階層を使用すると、解析は下位ランクのエッジよりも上位ランクのエッジを優先します。階層解析は、より高速で、運転者が遠回りであっても一般道路の代わりに高速道路を利用する状況をシミュレートするのに使用できます。このオプションは、Network Analyst レイヤが参照しているネットワーク データセットに階層属性がある場合のみ適用されます。値を True に設定することでも、このオプションを指定できます。 NO_HIERARCHY（階層を使用しない） —階層属性を解析に使用しません。階層を使用しないことで、ネットワーク データセットの正確なルートが検索されます。値を False に設定することでも、このオプションを指定できます。	String
useTimeWindows (読み書き)	Controls if time windows will be used at the stops. The following is a list of possible values: USE_TIMEWINDOWS —The route will consider time windows on the stops. If a stop is arrived at before its time window, there will be wait time until the time window starts. If a stop is arrived at after its time window, there will be a time-window violation. Total time-window violation is balanced against minimum impedance when computing the route. This option is applicable only when the network cost attribute specified as the value for impedance property is in time units. A value of True can also be used to specify this option. NO_TIMEWINDOWS —The route will ignore time windows on the stops. A value of False can also be used to specify this option.	String

コードのサンプル

RouteSolverProperties の例 1（Python ウィンドウ）

次のスクリプトは、インピーダンス プロパティを TravelTime コスト属性に更新し、コスト属性の Minutes と Meters を累積属性として指定して、ルートの開始時間に現在の時間を使用する方法を示しています。San Francisco 地域のチュートリアル データセットに基づいて、新しいマップ ドキュメントに Route という名前のルート ネットワーク解析レイヤが作成されていることを想定しています。

#Get the route layer object from a layer named "Route" in the table of contents
routeLayer = arcpy.mapping.Layer("Route")

#Get the route solver properties object from the route layer
solverProps = arcpy.na.GetSolverProperties(routeLayer)

#Update the properties for the route layer using the route solver properties object
solverProps.impedance = "TravelTime"
solverProps.accumulators = ["Meters", "Minutes"]
#Only set the time component from the current date time as time of day
solverProps.timeOfDay = datetime.datetime.now().time()

RouteSolverProperties の例 2（ワークフロー）

次のスクリプトは、一連のストップ間の最短（距離）ルートと最速（移動時間）ルートを検索し、各ルートをジオデータベースにフィーチャクラスとして保存する方法を示しています。ルート レイヤのインスタンスを 1 つだけ作成し、RouteSolverProperties オブジェクトを使用してインピーダンス プロパティを変更し、目的の結果を得る方法を示しています。

import arcpy

#Set up the environment
arcpy.env.overwriteOutput = True
arcpy.CheckOutExtension("network")

#Set up variables
networkDataset = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
stops = "C:/Data/SanFrancisco.gdb/Analysis/Stores"
fastestRoute = "C:/Data/SanFrancisco.gdb/FastestRoute"
shortestRoute = "C:/Data/SanFrancisco.gdb/ShortestRoute"

#Make a new route layer using travel time as impedance to determine fastest route
routeLayer = arcpy.na.MakeRouteLayer(networkDataset, "StoresRoute",
                                     "TravelTime").getOutput(0)

#Get the network analysis class names from the route layer
naClasses = arcpy.na.GetNAClassNames(routeLayer)

#Get the routes sublayer from the route layer
routesSublayer = arcpy.mapping.ListLayers(routeLayer, naClasses["Routes"])[0]

#Load stops
arcpy.na.AddLocations(routeLayer, naClasses["Stops"], stops)

#Solve the route layer
arcpy.na.Solve(routeLayer)

#Copy the route as a feature class
arcpy.management.CopyFeatures(routesSublayer, fastestRoute)

#Get the RouteSolverProperties object from the route layer to modify the
#impedance property of the route layer.
solverProps = arcpy.na.GetSolverProperties(routeLayer)

#Set the impedance property to "Meters" to determine the shortest route.
solverProps.impedance = "Meters"

#Resolve the route layer
arcpy.na.Solve(routeLayer)

#Copy the route as a feature class
arcpy.management.CopyFeatures(routesSublayer, shortestRoute)

arcpy.AddMessage("Completed")