FindRoutes サービスが正常に実行されると、以下に示す出力パラメーターを使用して、ストップ間の最適なルートと解析が成功したかどうかを示すステータスを返します。
output_routes
結果ルートへのアクセスを提供します。
出力ルートに返されるフィールドを次の表に示します。
| フィールド | 説明 |
|---|---|
Name | ルートの名前は、関連付けられているストップの RouteName フィールドに基づきます。入力 RouteName フィールドが NULL である場合、名前は最初と最後のストップの Name フィールドから取得されます。 |
StopCount | ルートに割り当てられるストップの数。 |
StartTime | ルートの開始時刻。最初のストップのタイム ゾーンとして報告されます。 |
EndTime | ルートの終了時刻。最後のストップのタイム ゾーンとして報告されます。 |
StartTimeUTC | ルートの開始時刻 (UTC (世界協定時))。 |
EndTimeUTC | UTC (協定世界時) でのルートの終了時刻。 |
Total_Minutes | ルートの最初のストップの開始から最後のストップの終了までの累積移動時間 (分単位)。指定されている場合の訪問済みストップの AdditionalTime が含まれます。 メモ:measurement_units が時間ベースであり、値が Minutes に設定されていない場合、Total_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各時間ベースのコスト属性に対し、Total_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
Total_Miles | ルートの最初のストップの開始から最後のストップの終了までの累積移動距離 (マイル単位)。指定されている場合の訪問済みストップの AdditionalDistance が含まれます。 メモ:measurement_units パラメーターが距離ベースであり、値が Miles または Kilometersに設定されていない場合、Total_[DistanceUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各距離ベースのコスト属性に対し、Total_[AccumulateAttributeName]_[DistanceUnits] が追加フィールドとして含まれます。 |
Total_Kilometers | ルートの最初のストップの開始から最後のストップの終了までの累積移動距離 (キロメートル単位)。指定されている場合の訪問済みストップの AdditionalDistance が含まれます。 |
Total_Other | ルートの最初のストップの開始から最後のストップの終了までの累積移動コスト (単位が不明)。指定されている場合の訪問済みストップの AdditionalCost が含まれます。 このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。 メモ:時間ベースでも距離ベースでもなく、かつ解析時に蓄積された各コスト属性に対し、Total_[AccumulateAttributeName]_Other フィールドが追加で含まれます。 |
TotalWait_Minutes | このフィールドには、ルートの全体の待機時間が格納されます。ルートの全体の待機時間とは、タイム ウィンドウの開始までストップで待機した時間のことです。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 メモ:measurement_units パラメーターが Minutes に設定されていない場合、TotalWait_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各時間ベースのコスト属性に対し、TotalWait_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
TotalViolation_Minutes | このフィールドには、ストップにおけるルートの全体の時間超過が格納されます。タイム ウィンドウが終了した後でルートがストップに到着すると、時間超過が追加されます。これは、入力ストップの ArriveTime フィールドと TimeWindowEnd フィールドとの差です。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 メモ:解析オブジェクトの timeUnits プロパティが TimeUnits.Minutes に設定されていない場合、TotalViolation_[TimeUnits] フィールドが追加されます。フィールド値の単位は、timeUnits プロパティで指定されます。 解析時に蓄積される各時間ベースのコスト属性に対し、TotalViolation_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
FirstStopOID | ルートの最初のストップの ObjectID 値。このフィールドは、多くの場合、入力ストップからの情報をルートに結合するために使用されます。 |
LastStopOID | ルートの最後のストップの ObjectID 値。このフィールドは、多くの場合、入力ストップからの情報をルートに結合するために使用されます。 |
output_directions
各結果ルートのターンごとのルート案内へのアクセスを提供します。
ルート案内フィーチャの形状は、ルートに含まれている下にある道路から決定されます。
[ルート案内言語]、[ルート案内距離単位]、[ルート案内スタイル名] の各パラメーターは、移動方向に影響します。[ルート案内の設定] パラメーターが [False] である場合、このパラメーターは空のフィーチャを返します。
出力ルート案内に返されるフィールドを次の表に示します。
| フィールド | 説明 |
|---|---|
RouteName | 運転動作が適用されるルートの名前。この値は、出力ルートの Name フィールドと同じです。 |
ArriveTime | 指定された運転動作を開始する時間。ルートが複数日にまたがる場合、日付と時刻が表示されます。 |
Type | ルート案内フィーチャが表す走行のタイプまたはルート案内テキストのタイプ。Type が走行タイプまたはルート案内文字列タイプのいずれを参照しているかを判断するには、SubItemType フィールドの値を確認します。 Type は、たとえば、走行タイプに基づいてルート案内テキストに対応するアイコンを割り当てたり、アプリケーションでルート案内を表示する際に、ルート案内文字列タイプに基づいた書式設定スタイルを使用したりすることができます。 Type 値は、下に示された Maneuver Types または Directions String Types の整数です。 走行タイプ
ルート案内文字列タイプ
|
SubItemType | Type フィールドが Directions String Types テーブルの整数または Maneuver Types テーブルの整数のいずれを参照するかを指定します。
|
Text | テキストによる移動方向の説明。 |
ElaspsedTime | 現在のルート案内が開始してから次のルート案内が開始するまで、または最後のルート案内が終了するまでの経過時間 (分)。 |
DriveDistance | 現在のルート案内が発生した場所から次のルート案内が発生する場所まで、または最後のルート案内が終了する場所までの距離。 この値の単位は、Directions_Distance_Units パラメーターで指定されます。 次のルート案内が開始する場所と同じ場所で発生するルート案内の場合、値は 0 です。たとえば、ルートの開始でのルート案内テキストの場合、DriveDistance は 0 です。 |
output_stops
ルートによって訪問されたストップや、どのルートでも到達できないストップの属性へのアクセスを提供します。
このパラメーターの属性 (Status フィールドなど) を使用すると、ストップがどのルートにも割り当てられなかった理由を確認できます。
出力ストップに返されるフィールドを次の表に示します。このパラメーターには、これらのフィールド以外に、解析のストップとして使用される入力フィーチャクラスのすべてのフィールドも含まれます。
フィールド | 説明 |
Name | ルートによって訪問されたストップの名前。このフィールドの値は、入力ストップの Name フィールドからコピーされます。 |
RouteName | ストップが割り当てられるルートの名前。 ツールの実行時に同じルート名を持つ複数の入力ストップはグループ化され、1 つのルートで移動し、ルートにその名前が割り当てられます。入力ストップに複数のルート名が存在する場合、ツールはルート名ごとに 1 つのルートを割り当てて、複数のルートを出力できます。 名前が存在しなければ、すべてのストップが同じルートに属します。 |
Sequence | 割り当てられたルートを訪問するストップの順序。RouteName フィールドにリストされます。 |
TimeWindowStart | ルートがストップを訪問できる最も早い時刻。このフィールドの値は、入力ストップの TimeWindowStart フィールドからコピーされます。 |
TimeWindowEnd | ルートがストップを訪問できる最も遅い時刻。このフィールドの値は、入力ストップの TimeWindowEnd フィールドからコピーされます。 |
ArriveCurbApproach | 車両がストップに到着するときに、アプローチを車両のどちら側にするかを示します。 |
DepartCurbApproach | 車両がストップから出発するときに、アプローチを車両のどちら側にするかを示します。 |
ArriveTime | ストップに到着した時刻を示す日時の値。この時間値のタイム ゾーンは、ストップが配置されているネットワーク エレメントから取得されます。 |
DepartTime | ストップからの開始時刻を示す日時の値。この時間値のタイム ゾーンは、ストップが配置されているネットワーク エレメントから取得されます。 |
ArriveTimeUTC | ストップに到着した時刻を示す日時の値。この時間値のタイム ゾーンは、ストップが配置されているネットワーク エレメントから取得されます。 |
DepartTimeUTC | ストップからの開始時刻を UTC (世界協定時) で示す日時の値。 |
LocationType | ストップ タイプ。このフィールドの値は、入力ストップの LocationType フィールドからコピーされます。 |
SourceID | 入力ポイントが配置されたネットワーク データセット ソース フィーチャクラスの数値 ID。 |
SourceOID | 入力ポイントが配置されたソースにあるフィーチャの ObjectID。 |
PosAlong | ソース ライン フィーチャのデジタイズ方向に沿った位置。この値は割合として格納されます。ネットワーク位置がジャンクションを参照している場合、このフィールドは NULL になります。 |
SideOfEdge | ライン フィーチャのデジタイズ方向を基準として定められる、エッジの側。このフィールドがとりうる値は、[右側] (1)、[左側] (2) のいずれかです。 |
CurbApproach | 車両がストップに到着する方向およびストップから出発する方向。このフィールドの値は、入力ストップの CurbApproach フィールドからコピーされます。 |
Status | ストップが解析でどのように評価されたかを示します。このフィールドを使用して、ルートに割り当てられなかったストップを判定できます。出力される可能性のある値は次のとおりです。
|
SnapX | ネットワーク データセットの座標系で、ポイントが配置されたネットワーク データセット上の位置の X 座標。 |
SnapY | ネットワーク データセットの座標系で、ポイントが配置されたネットワーク データセット上の位置の Y 座標。 |
SnapZ | ネットワーク データセットの座標系で、ポイントが配置されたネットワーク データセット上の位置の Z 座標。ネットワークが 2 次元の場合、SnapZ フィールドは 0 になります。 |
DistanceToNetworkInMeters | ポイントの地理的位置とそのポイントがネットワーク上に配置された位置との間の距離 (メートル単位)。 |
AdditionalTime | このストップを訪問するときの合計ルート所要時間に追加される時間の長さ。このフィールドの値は、入力ストップの AdditionalTime フィールドからコピーされます。 |
AdditionalDistance | このストップを訪問するときの合計ルート距離に追加される距離の長さ。このフィールドの値は、入力ストップの AdditionalDistance フィールドからコピーされます。 |
AdditionalCost | このストップを訪問するときに、合計ルート コストに追加されるコスト。このフィールドの値は、入力ストップの AdditionalCost フィールドからコピーされます。このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。 |
Cumul_Minutes | 起点からストップまでのルートの累積所要時間 (分)。ここに報告される値は、ストップまでの累積ルート時間です。これには、このストップおよびそれ以前のストップでの追加の時間が含まれます。 たとえば、ルート解析で、2 つのストップを訪問するのに 10 分かかり、2 番目のストップの AdditionalTime の値が 5 の場合、Cumul_Minutes の値は 15 分になります。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、Cumul_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各時間ベースのコスト属性に対し、Cumul_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
Cumul_Miles | 起点からストップまでのルートの累積距離 (マイル)。ここに報告される値は、ストップまでの累積ルート距離です。これには、このストップおよびそれ以前のストップでの追加の距離が含まれます。 メモ:measurement_units パラメーターが距離ベースであり、値が Miles または Kilometersに設定されていない場合、Cumul_[DistanceUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各距離ベースのコスト属性に対し、Cumul_[AccumulateAttributeName]_[DistanceUnits] が追加フィールドとして含まれます。 |
Cumul_Kilometers | 起点からストップまでのルートの累積距離 (キロメートル)。ここに報告される値は、ストップまでの累積ルート距離です。これには、このストップおよびそれ以前のストップでの追加の距離が含まれます。 |
Cumul_Cost | 起点からストップまでのルートの累積コスト。ここに報告される値は、ストップまでの累積ルート コストです。これには、このストップおよびそれ以前のストップでの追加のコストが含まれます。このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。この値の単位は不明です。 メモ:時間ベースでも距離ベースでもなく、かつ解析時に蓄積された各コスト属性に対し、Cumul_[AccumulateAttributeName]_Other フィールドが追加で含まれます。 |
Wait_Minutes | このフィールドには、ルートがストップに早く到着した場合にタイム ウィンドウが開始する () のを待つのに費やされる時間が格納されます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、Wait_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各時間ベースのコスト属性に対し、Wait_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
CumulWait_Minutes | このフィールドには、タイム ウィンドウが開始するのを待つのに費やされた時間の合計が格納されます。待ち時間が計測されます。これには、ルートが訪れた現在のストップとそれ以前のすべてのストップでの待ち時間が含まれます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、CumulWait_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各時間ベースのコスト属性に対し、CumulWait_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
Violation_Minutes | このフィールドは、タイム ウィンドウが終了した後にルートがどれほど遅く到着したかを示します。具体的には、これには、タイム ウィンドウの終了時刻からルートがストップに到着した時刻までの時間が格納されます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、Violation_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 解析時に蓄積される各時間ベースのコスト属性に対し、Violation_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
CumulViolation_Minutes | このフィールドには、該当するルートで訪れた現在のストップとそれより前のすべてのストップの累積超過時間が格納されます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、CumulViolation_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析オブジェクトの timeUnits プロパティが TimeUnits.Minutes に設定されていない場合、CumulViolation_[TimeUnits] フィールドが追加されます。フィールド値の単位は、timeUnits プロパティで指定されます。 解析時に蓄積される各時間ベースのコスト属性に対し、CumulViolation_[AccumulateAttributeName]_[TimeUnits] が追加フィールドとして含まれます。 |
ORIG_FID | 入力ストップの ObjectID。このフィールドを使用して、出力ストップから入力ストップ、または入力ストップから出力ストップに属性を結合できます。 |
Bearing | このフィールドの値は、入力ストップの Bearing フィールドからコピーされます。 |
BearingTol | このフィールドの値は、入力ストップの BearingTol フィールドからコピーされます。 |
NavLatency | このフィールドの値は、入力ストップの NavLatency フィールドからコピーされます。 |
output_route_edges
ルートが移動する個々のネットワーク エッジへのアクセスを提供します。
このパラメーターは、populate_route_edges パラメーターが True に設定された場合にのみ値を持ちます。
出力ルート エッジがサポートするフィールドを次の表に示します。
| フィールド | 説明 |
|---|---|
SourceName | ラインを生成する元になったエッジ ソース フィーチャクラスの名前。 |
SourceOID | 商圏内道路フィーチャの ObjectID。このフィールドの値を集計すると、特定の道路フィーチャがすべてのルートに含まれる回数など、役に立つ情報を得ることができます。 |
RouteEdgeID | 道路フィーチャを構成するエッジを表す ID。1 つの道路フィーチャには複数のエッジが存在する可能性があるため、SourceOID フィールドを使用して商圏内道路を一意に識別したり、RouteEdgeID フィールドを使用して商圏内道路フィーチャ内にあるエッジを一意に識別することができます。 |
FromPosition | 基礎となる道路フィーチャをデジタイズした方向を基準にして、出力 RouteEdges フィーチャが始まる場所を指定します。
|
ToPosition | 基礎となる道路フィーチャをデジタイズした方向を基準にして、出力 RouteEdges フィーチャが始まる場所を指定します。
|
RouteID | エッジを通過したルートを一意に識別します。 RouteID の値は、出力ルートの ObjectID 値に対応します。 |
Attr_Minutes | 基礎となる道路フィーチャの通過部分の移動時間 (分)。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、Attr_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 |
Attr_Miles | 基礎となる道路フィーチャの通過部分の長さ (マイル)。 メモ:measurement_units パラメーターが距離ベースであり、値が Miles または Kilometersに設定されていない場合、Attr_[DistanceUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 |
Attr_Kilometers | 基礎となる道路フィーチャの通過部分の長さ (キロメートル)。 |
Attr_Other | 基礎となる道路フィーチャの通過部分の移動コスト。このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。この値の単位は不明です。 メモ:時間ベースでも距離ベースでもなく、かつ解析時に蓄積された各コスト属性に対し、Attr_[AccumulateAttributeName] フィールドが追加で含まれます。 |
Cumul_Minutes | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの移動時間 (分)。 メモ:measurement_units パラメーターが時間ベースであり、値が Minutes ではない場合、Cumul_[TimeUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各時間ベースのコスト属性に対し、Cumul_[AccumulateAttributeName] が追加フィールドとして含まれます。値は、解析で使用される時間単位で表されます。 |
Cumul_Miles | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの長さ (マイル)。 メモ:measurement_units パラメーターが距離ベースであり、値が Miles または Kilometersに設定されていない場合、Cumul_[DistanceUnits] フィールドが追加されます。フィールド値の単位は、measurement_units パラメーターで指定されます。 メモ:解析時に蓄積される各距離ベースのコスト属性に対し、Cumul_[AccumulateAttributeName] が追加フィールドとして含まれます。値は、解析で使用される距離単位で表されます。 |
Cumul_Kilometers | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの長さ (キロメートル)。 |
Cumul_Other | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの移動コスト。このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。この値の単位は不明です。 メモ:時間ベースでも距離ベースでもなく、かつ解析時に蓄積された各コスト属性に対し、Cumul_[AccumulateAttributeName] フィールドが追加で含まれます。 |
Attr_[Soft Restriction Attribute Name] | 通過したエッジが、このフィールド名で参照されているソフトな規制属性を使用したかどうかを指定します。
たとえば、解析が [Avoid Toll Roads] というソフトな規制を使用して実行された場合、このソフトな規制に Attr_Avoid_Toll_Roads というフィールドが作成されます。このフィールドの値が 1 の場合、ルート内の有料道路を表します。 |
solve_succeeded
このパラメーターを使用し、解析が成功したかどうかを確認します。
output_result_file
このパラメーターを使用し、解析の結果にアクセスします。解析の結果は、出力ごとに 1 つまたは複数のファイルを含む *.zip ファイルとして提供されます。個々のファイルの形式は [出力形式] パラメーターで指定されます。このパラメーター値は、[出力形式] パラメーターが [フィーチャ セット] である場合は設定されません。
[JSON ファイル] や [GeoJSON ファイル] など、ファイルベースの出力形式が指定されている場合は、ディスプレイに出力は追加されません。これは、ArcMap や ArcGIS Pro のようなアプリケーションは結果ファイルのコンテンツを描画しないからです。代わりに、結果ファイルはコンピューター上の一時ディレクトリにダウンロードされます。ArcGIS Pro でダウンロードされたファイルの場所を調べるには、プロジェクトのジオプロセシング履歴で、ツールの実行に対応するエントリの [出力結果ファイル] パラメーターを表示します。ArcMap でファイルの場所を調べるには、[ジオプロセシング結果] ウィンドウで、ツールの実行に対応するエントリの [出力結果ファイル] パラメーターから、ショートカット メニューの [ロケーションのコピー] オプションにアクセスします。
output_route_data
このパラメーターを使用して、ルート レイヤーを ArcGIS Online または Portal for ArcGIS で共有するために使用できる形式で、解析の入力と出力を保持するファイル ジオデータベースを含む *.zip ファイルにアクセスします。このパラメーター値は、[ルート データの保存] パラメーターが [True] の場合にのみ設定されます。
このファイルは、コンピューター上の一時ディレクトリにダウンロードされます。ArcGIS Pro でダウンロードされたファイルの場所を調べるには、プロジェクトのジオプロセシング履歴で、ツールの実行に対応するエントリの [出力ルート データ] パラメーターを表示します。ArcMap でファイルの場所を調べるには、[ジオプロセシング結果] ウィンドウで、ツールの実行に対応するエントリの [出力ルート データ] パラメーターから、ショートカット メニューの [ロケーションのコピー] オプションにアクセスします。
output_network_analysis_layer
このパラメーターを使用し、解析の設定と、解析に使用される入力と出力を格納するネットワーク解析レイヤー ファイルにアクセスします。このパラメーター値は、[出力ネットワーク解析レイヤーの保存] パラメーターが [True] の場合にのみ設定されます。
このファイルは、コンピューター上の一時ディレクトリにダウンロードされます。ArcGIS Pro でダウンロードされたファイルの場所を調べるには、プロジェクトのジオプロセシング履歴で、ツールの実行に対応するエントリの [出力ネットワーク解析レイヤー] パラメーターを表示します。ArcMap でファイルの場所を調べるには、[ジオプロセシング結果] ウィンドウで、ツールの実行に対応するエントリの [出力ネットワーク解析レイヤー] パラメーターから、ショートカット メニューの [ロケーションのコピー] オプションにアクセスします。
メモ:
このファイルは、ArcMap などの ArcGIS Desktop アプリケーションで開いた場合でも、直接操作することはできません。データ ソースが有効ではないからです。このファイルは、ツールから返される結果の品質を診断するために、Esri テクニカル サポートに送信されることを想定しています。