ルート検索 (Find Routes) の出力
FindRoutes サービスが正常に実行されると、次に示す出力パラメーターを使用して、ストップ間の最適なルートと解析に成功したかどうかを示すステータスが返されます。
output_routes
結果ルートへのアクセスを提供します。
出力ルートに返されるフィールドを次の表に示します。
|
フィールド |
説明 |
|---|---|
|
|
ルートの名前は、関連付けられているストップの |
|
|
ルートに割り当てられるストップの数。 |
|
|
ルートの開始時刻。最初のストップのタイム ゾーンとして報告されます。 |
|
|
ルートの終了時刻。最後のストップのタイム ゾーンとして報告されます。 |
|
|
UTC (協定世界時) でのルートの開始時刻。 |
|
|
UTC (協定世界時) でのルートの終了時刻。 |
|
|
ルートの最初のストップの開始から最後のストップの終了までの累積移動時間 (分)。 指定されている場合の訪問済みストップの 注意:
注意:解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
ルートの最初のストップの開始から最後のストップの終了までの累積移動距離 (マイル)。 指定されている場合の訪問済みストップの 注意:
注意:解析時に蓄積される距離ベースのコスト属性ごとに |
|
|
ルートの最初のストップの開始から最後のストップの終了までの累積移動距離 (キロメートル)。 指定されている場合の訪問済みストップの |
|
|
ルートの最初のストップの開始から最後のストップの終了までの累積移動コスト (単位は不明)。 指定されている場合の訪問済みストップの このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。 注意:時間ベースでも距離ベースでもなく、解析時に蓄積されるコスト属性ごとに |
|
|
このフィールドには、ルートの全体の待機時間が格納されます。ルートの全体の待機時間とは、タイム ウィンドウの開始までストップで待機した時間のことです。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 注意:
注意:解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
このフィールドには、ストップにおけるルートの全体の時間超過が格納されます。 タイム ウィンドウが終了した後でルートがストップに到着すると、時間超過が追加されます。これは、入力ストップの 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 注意:解析オブジェクトの 解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
ルート上の最初のストップの解析によって自動的に生成される一意の識別子。 |
|
|
ルートの最初のストップの |
|
|
ルート上の最後のストップの解析によって自動的に生成される一意の識別子。 |
|
|
ルートの最後のストップの |
output_directions
各結果ルートのルート案内へのアクセスを提供します。
レガシー:
この出力タイプは、 DirectionPoints と DirectionLines 出力クラスに取って代わられています。これらはすべての新しいスクリプトとワークフローに使用する必要があります。
ルート案内フィーチャの形状は、ルートに含まれている基礎となる道路から決定されます。
[ルート案内言語] 、 [ルート案内距離単位] 、 [ルート案内スタイル名] の各パラメーターは、移動方向に影響します。 [ルート案内の設定] パラメーターが [False] に設定されている場合、このパラメーターは空のフィーチャを返します。
出力ルート案内に返されるフィールドを次の表に示します。
|
フィールド |
説明 |
|---|---|
|
|
運転動作が適用されるルートの名前。 この値は、出力ルートの |
|
|
指定された運転動作を開始する時間。 ルートが複数日にまたがる場合、日付と時刻が表示されます。 |
|
|
ルート案内フィーチャが表すマヌーバー タイプまたはルート案内テキストのタイプ。
マヌーバー タイプ
ルート案内文字列タイプ
|
|
|
|
|
|
テキストによる移動方向の説明。 |
|
|
現在のルート案内が開始してから次のルート案内が開始するまで、または最後のルート案内が終了するまでの経過時間 (分)。 |
|
|
現在のルート案内が発生した場所から次のルート案内が発生する場所まで、または最後のルート案内が終了する場所までの距離。 この値の単位は、 次のルート案内が開始する場所と同じ場所で発生するルート案内の場合、値はゼロです。 たとえば、ルートの開始でのルート案内テキストの場合、 |
output_direction_points
解析で算出されたルートに対して出力されるルート案内を指定します。特定のルート案内イベントまたはマヌーバーが発生したルートに沿ったポイント位置として表されます。
|
フィールド名 |
説明 |
|---|---|
|
|
該当するルート案内ポイントが関連付けられている出力 |
|
|
該当するルートのルート案内ポイントの順番 (1 から始まる)。 |
|
|
ポイントで記述されたルート案内イベントまたはマヌーバー タイプを指定します。次のいずれかの値で表されます。
|
|
|
該当するルート案内ポイントが関連付けられているストップの ObjectID (ある場合)。 ポイントがストップへの訪問を表していない場合、この値は NULL になります。 |
|
|
使用中のアプリケーションで表示されるルート案内テキスト。 |
|
|
UTC (協定世界時) でのルート案内イベントの発生時刻。 |
|
|
マヌーバー位置の現地時間と |
|
|
ルート案内ポイントの名前。 |
|
|
ルート案内指示に表示される高速道路出口名。 |
|
|
ルート案内指示に表示される代替ソース名。 |
|
|
ルート案内指示に表示される交差点または交差道路の名前。 |
|
|
ルート案内指示に表示される分岐標識名。 |
|
|
ルート案内指示に表示される目的地までの方向標識名。 |
|
|
該当するルート案内イベントが発生した建物の階。 この値は、解析用のネットワーク データセット内に定義された |
|
|
使用中のアプリケーションで音声ガイダンス テキストとして使用される短い形式のテキスト。 |
|
|
使用中のアプリケーションで音声ガイダンス テキストとして使用される追加のテキスト (展開された略語と複数形の語句を含む)。 |
|
|
この地点を出発する車両の方位 (度単位)。 ゼロは北を示します。 |
output_direction_lines
これは、解析で算出され、 DirectionPoints イベント位置間またはマヌーバー位置間の各ルート セグメントを表すためにスライスされた出力ルート ラインです。
|
フィールド名 |
説明 |
|---|---|
|
|
該当するラインが関連付けられている |
|
|
該当するルート案内ラインが関連付けられている出力 |
|
|
該当するラインで記述されたルート案内状況のタイプを指定します。次のいずれかの値で表されます。
|
|
|
メートル単位で計測されたライン セグメントの長さ。 |
|
|
分単位でのライン セグメントに沿った移動時間。 |
|
|
該当するルート案内イベントが始まる建物の階。 この値は、解析用のネットワーク データセット内に定義された |
|
|
該当するルート案内イベントが終わる建物の階。 この値は、解析用のネットワーク データセット内に定義された |
output_stops
ルートによって訪問されたストップや、どのルートでも到達できないストップの属性へのアクセスを提供します。
このパラメーターの属性 (Status フィールドなど) を使用すると、ストップがどのルートにも割り当てられなかった理由を確認できます。
出力ストップに返されるフィールドを次の表に示します。 このパラメーターには、これらのフィールド以外に、解析のストップとして使用される入力フィーチャクラスのすべてのフィールドも含まれます。
|
フィールド |
説明 |
|
|
ルートによって訪問されたストップの名前。 このフィールドの値は、入力ストップの |
|
|
ストップが割り当てられるルートの名前。 ツールの実行時に同じルート名を持つ複数の入力ストップはグループ化され、1 つのルートで移動し、ルートにその名前が割り当てられます。 入力ストップに複数のルート名が存在する場合、ツールはルート名ごとに 1 つのルートを割り当てて、複数のルートを出力できます。 名前が指定されていない場合、すべてのストップが同じルートに属します。 |
|
|
割り当てられたルートで訪問するストップの順序。 |
|
|
ルートがストップを訪問できる最も早い時刻。 このフィールドの値は、入力ストップの |
|
|
ルートがストップを訪問できる最も遅い時刻。 このフィールドの値は、入力ストップの |
|
|
車両がストップに到着するときに、アプローチを車両のどちら側にするかを示します。 |
|
|
車両がストップから出発するときに、アプローチを車両のどちら側にするかを示します。 |
|
|
ストップに到着した時刻を示す日時の値。 この時間値のタイム ゾーンは、ストップが配置されているネットワーク エレメントから取得されます。 |
|
|
ストップからの開始時刻を示す日時の値。 この時間値のタイム ゾーンは、ストップが配置されているネットワーク エレメントから取得されます。 |
|
|
ストップに到着した時刻を示す日時の値。 この時間値のタイム ゾーンは、ストップが配置されているネットワーク エレメントから取得されます。 |
|
|
ストップからの開始時刻を UTC (協定世界時) で示す日時の値。 |
|
|
ストップ タイプ。 このフィールドの値は、入力ストップの |
|
|
入力ポイントが配置されたネットワーク データセット ソース フィーチャクラスの数値 ID。 |
|
|
入力ポイントが配置されたソースにあるフィーチャの ObjectID。 |
|
|
ソース ライン フィーチャのデジタイズ方向に沿った位置。この値は割合として格納されます。ネットワーク位置がジャンクションを参照している場合、このフィールドは NULL になります。 |
|
|
ライン フィーチャのデジタイズ方向を基準として定められる、エッジの側。このフィールドがとりうる値は、[右側] (1)、[左側] (2) のいずれかです。 |
|
|
車両がストップに到着する方向およびストップから出発する方向。 このフィールドの値は、入力ストップの |
|
|
ネットワーク上の位置を基準としたその地点のステータスと解析の結果を指定します。 出力される可能性のある値は次のとおりです。
|
|
|
ネットワーク データセットの座標系で、ポイントが配置されたネットワーク データセット上の位置の X 座標。 |
|
|
ネットワーク データセットの座標系で、ポイントが配置されたネットワーク データセット上の位置の Y 座標。 |
|
|
ネットワーク データセットの座標系で、ポイントが配置されたネットワーク データセット上の位置の Z 座標。ネットワークが 2 次元の場合、 |
|
|
ポイントの地理的位置とそのポイントがネットワーク上に配置された位置との間の距離 (メートル単位)。 |
|
|
このストップを訪問するときの合計ルート所要時間に追加される時間の長さ。 このフィールドの値は、入力ストップの |
|
|
このストップを訪問するときの合計ルート距離に追加される距離の長さ。 このフィールドの値は、入力ストップの |
|
|
このストップを訪問するときに、合計ルート コストに追加されるコスト。 このフィールドの値は、入力ストップの |
|
|
起点からストップまでのルートの累積所要時間 (分)。 ここに報告される値は、ストップまでの累積ルート時間です。これには、このストップおよびそれ以前のストップでの追加の時間が含まれます。 たとえば、ルート解析で、2 つのストップを訪問するのに 10 分かかり、2 番目のストップの 注意:
注意:解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
起点からストップまでのルートの累積距離 (マイル)。 ここに報告される値は、ストップまでの累積ルート距離です。これには、このストップおよびそれ以前のストップでの追加の距離が含まれます。 注意:
注意:解析時に蓄積される距離ベースのコスト属性ごとに |
|
|
起点からストップまでのルートの累積距離 (キロメートル)。 ここに報告される値は、ストップまでの累積ルート距離です。これには、このストップおよびそれ以前のストップでの追加の距離が含まれます。 |
|
|
起点からストップまでのルートの累積コスト。 ここに報告される値は、ストップまでの累積ルート コストです。これには、このストップおよびそれ以前のストップでの追加のコストが含まれます。 このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。 この値の単位は不明です。 注意:時間ベースでも距離ベースでもなく、解析時に蓄積されるコスト属性ごとに |
|
|
このフィールドには、ルートがストップに早く到着した場合にタイム ウィンドウが開始するのを待つのに費やされる時間が格納されます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 注意:
注意:解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
このフィールドには、タイム ウィンドウが開始するのを待つのに費やされた時間の合計が格納されます。 待ち時間が計測されます。 これには、ルートが訪れた現在のストップとそれ以前のすべてのストップでの待ち時間が含まれます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 注意:
注意:解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
このフィールドは、タイム ウィンドウが終了した後にルートがどれほど遅く到着したかを示します。 具体的には、これには、タイム ウィンドウの終了時刻からルートがストップに到着した時刻までの時間が格納されます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 注意:
解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
このフィールドには、該当するルートで訪れた現在のストップとそれより前のすべてのストップの累積超過時間が格納されます。 解析でタイム ウィンドウが使用されない場合は、フィールドの値は Null になります。 注意:
注意:解析オブジェクトの 解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
入力ストップの |
|
|
このフィールドの値は、入力ストップの |
|
|
このフィールドの値は、入力ストップの |
|
|
このフィールドの値は、入力ストップの |
output_route_edges
ルートが移動する個々のネットワーク エッジへのアクセスを提供します。
このパラメーターは、 populate_route_edges パラメーターが True に設定されている場合にのみ値を持ちます。
出力ルート エッジがサポートするフィールドを次の表に示します。
|
フィールド |
説明 |
|---|---|
|
|
ラインを生成する元になったエッジ ソース フィーチャクラスの名前。 |
|
|
商圏内道路フィーチャの |
|
|
道路フィーチャを構成するエッジを表す ID。 1 つの道路フィーチャに複数のエッジが存在する可能性があるため、 |
|
|
基礎となる道路フィーチャをデジタイズした方向を基準にして、出力
|
|
|
基礎となる道路フィーチャをデジタイズした方向を基準にして、出力
|
|
|
|
|
|
|
|
|
エッジを通過したルートを一意に識別します。
|
|
|
基礎となる道路フィーチャの通過部分の移動時間 (分)。 注意:
|
|
|
基礎となる道路フィーチャの通過部分の長さ (マイル)。 注意:
|
|
|
基礎となる道路フィーチャの通過部分の長さ (キロメートル)。 |
|
|
基礎となる道路フィーチャの通過部分の移動コスト。 このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。 この値の単位は不明です。 注意:時間ベースでも距離ベースでもなく、解析時に蓄積されるコスト属性ごとに |
|
|
この基礎となる道路フィーチャの通過部分の始点から終点までのルートの移動時間 (分)。 注意:
注意:解析時に蓄積される時間ベースのコスト属性ごとに |
|
|
この基礎となる道路フィーチャの通過部分の始点から終点までのルートの長さ (マイル)。 注意:
注意:解析時に蓄積される距離ベースのコスト属性ごとに |
|
|
この基礎となる道路フィーチャの通過部分の始点から終点までのルートの長さ (キロメートル)。 |
|
|
この基礎となる道路フィーチャの通過部分の始点から終点までのルートの移動コスト。 このフィールドは、解析の移動モードが時間ベースでも距離ベースでもないインピーダンス属性を使用する場合にのみ含まれます。 この値の単位は不明です。 注意:時間ベースでも距離ベースでもなく、解析時に蓄積されるコスト属性ごとに |
|
|
通過したエッジが、このフィールド名で参照されているソフトな規制属性を使用したかどうかを指定します。
たとえば、解析が Avoid Toll Roads というソフトな規制を使用して実行された場合、このソフトな規制に |
solve_succeeded
このパラメーターを使用し、解析が成功したかどうかを確認します。
output_result_file
このパラメーターを使用し、解析の結果にアクセスします。解析の結果は、出力ごとに 1 つまたは複数のファイルを含む .zip ファイルとして提供されます。 個々のファイルの形式は [出力形式] パラメーターで指定されます。 このパラメーター値は、 [出力形式] パラメーターが [フィーチャ セット] である場合は設定されません。
[JSON ファイル] や [GeoJSON ファイル] など、ファイルベースの出力形式が指定されている場合は、ディスプレイに出力は追加されません。これは、ArcMap や ArcGIS Pro のようなアプリケーションは結果ファイルのコンテンツを描画しないからです。 代わりに、結果ファイルはコンピューター上の一時ディレクトリにダウンロードされます。 ArcGIS Pro でダウンロードされたファイルの場所を調べるには、プロジェクトのジオプロセシング履歴で、ツールの操作に対応するエントリの [出力結果ファイル] パラメーター値を表示します。 ArcMap でファイルの場所を調べるには、 [ジオプロセシング結果] ウィンドウで、ツールの操作に対応するエントリの [出力結果ファイル] パラメーターから、ショートカット メニューの [ロケーションのコピー] オプションにアクセスします。
output_route_data
このパラメーターを使用すると、ルート レイヤーを .zip または ArcGIS Online で共有するために使用できる形式で、解析の入力と出力を保持するファイル ジオデータベースを含む Portal for ArcGIS ファイルにアクセスできます。 このパラメーター値は、 [ルート データの保存] パラメーターが [True] の場合にのみ設定されます。
このファイルは、コンピューター上の一時ディレクトリにダウンロードされます。 ArcGIS Pro でダウンロードされたファイルの場所を調べるには、プロジェクトのジオプロセシング履歴で、ツールの操作に対応するエントリの [出力ルート データ] パラメーター値を表示します。 ArcMap でファイルの場所を調べるには、 [ジオプロセシング結果] ウィンドウで、ツールの操作に対応するエントリの [出力ルート データ] パラメーターから、ショートカット メニューの [ロケーションのコピー] オプションにアクセスします。
output_network_analysis_layer
このパラメーターを使用し、解析の設定と、解析に使用される入力と出力を格納するネットワーク解析レイヤー ファイルにアクセスします。 このパラメーター値は、 [出力ネットワーク解析レイヤーの保存] パラメーターが [True] の場合にのみ設定されます。
このファイルは、コンピューター上の一時ディレクトリにダウンロードされます。 ArcGIS Pro でダウンロードされたファイルの場所を調べるには、プロジェクトのジオプロセシング履歴で、ツールの操作に対応するエントリの [出力ネットワーク解析レイヤー] パラメーター値を表示します。 ArcMap でファイルの場所を調べるには、 [ジオプロセシング結果] ウィンドウで、ツールの操作に対応するエントリの [出力ネットワーク解析レイヤー] パラメーターから、ショートカット メニューの [ロケーションのコピー] オプションにアクセスします。
注意:
このファイルは、ArcGIS Desktop などの ArcMap アプリケーションで開いた場合でも、直接操作することはできません。データ ソースが有効ではないからです。 このファイルは、ツールから返される結果の品質を診断するために、Esri テクニカル サポートに送信されることを想定しています。