このサービスは、正常に実行されると、次の出力パラメーターを使用して、ストップ間の最適なルートと解析が成功したかどうかを示すステータスを返します。
output_routes
このパラメーターを使用して、ストップ間に生成されたルートにアクセスします。
ルートごとに返されるフィールドの説明を以下に示します。
フィールド名 | 説明 |
---|---|
OID | ルートの一意な ID。この識別子は、サービスによって自動生成されます。 |
ストップ名 | ルートの名前は、関連付けられているストップの [RouteName] フィールドに基づきます。入力 [RouteName] フィールドが NULL である場合、名前は最初と最後のストップの [Name] フィールドから取得されます。 |
StopCount | ルートに割り当てられるストップの数。 |
Total_Minutes | ストップ間のルートの累積移動時間 (分)。 |
FirstStopOID | ルートの最初のストップの ObjectID 値。このフィールドは、多くの場合、入力ストップからの情報をルートに結合するために使用されます。 |
LastStopOID | ルートの最後のストップの ObjectID 値。このフィールドは、多くの場合、入力ストップからの情報をルートに結合するために使用されます。 |
Total_Kilometers | ストップ間のルートの累積移動距離 (キロメートル)。 |
Total_Miles | ストップ間のルートの累積移動距離 (マイル)。 |
Shape_Length | ルート ジオメトリに対して指定された空間参照の単位でのルートの長さ。env:outSR パラメーターが指定されない場合、この長さはデフォルトで度 (10 進) 単位でレポートされます。 |
output_directions
このパラメーターを使用して、ストップ間に生成されたルートごとに、ターンごとのルート案内にアクセスします。このパラメーターは、ルート案内に加えて、テキストに対応するルート案内フィーチャのジオメトリも含んでいます。ルート案内フィーチャの形状は、ルートに含まれている下にある道路から決定されます。フィーチャ ジオメトリは、env:outSR パラメーターで指定された空間参照で返されます。populate_directions パラメーターが false である場合、フィーチャは空になります。directions_language、directions_distance_units、 および directions_style_name の各パラメーターは、ルート案内に大きな影響を与えます。
ルート案内フィーチャに関して返されるフィールドの説明を以下に示します。
フィールド名 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ObjectID | ルート案内フィーチャの一意の識別子。この識別子は、サービスによって自動生成されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RouteName | 運転動作が適用されるルートの名前。 この値は、output_routes パラメーターの Name 属性と同じです。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ArriveTime | 指定された運転動作を開始する時間。ルートが複数日にまたがる場合、日付と時刻が表示されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Type | ルート案内フィーチャが表す走行のタイプまたはルート案内テキストのタイプを示します。[Type] が走行タイプまたはルート案内文字列タイプのいずれを参照しているかを判断するには、[SubItemType] フィールドの値を確認する必要があります。 [Type] は、たとえば、走行タイプに基づいてルート案内テキストに異なるアイコンを割り当てたり、アプリケーションでルート案内を表示する際に、ルート案内文字列タイプに基づいて特殊な書式設定スタイルを使用するために使用できます。 [Type] 値は、下に示された Maneuver Types テーブルまたは Directions String Types テーブルの整数です。 Maneuver Types
Directions String Types
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | Type フィールドが Directions String Types テーブルの整数または Maneuver Types テーブルの整数のいずれを参照するかを指定します。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Text | テキストによるルート案内の説明です。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | 現在のルート案内が開始してから次のルート案内が開始するまで、または最後のルート案内が終了するまでの経過時間 (分)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | 現在のルート案内が発生した場所から次のルート案内が発生する場所まで、または最後のルート案内が終了する場所までの距離。この値の単位は、distance_units パラメーターで指定されます。 次のルート案内が開始する場所と同じ場所で発生するルート案内の場合、値は 0 です。たとえば、ルートの開始でのルート案内テキストの場合、DriveDistance は 0 です。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | ルートに対して指定された空間参照の単位でのルート案内フィーチャの長さ。env:outSR パラメーターが指定されない場合、この長さはデフォルトで度 (10 進) 単位でレポートされます。 |
output_stops
このパラメーターを使用して、ルートによって訪問されたストップや、ルートで到着できなかったストップの属性にアクセスします。到着できたストップの場合、属性テーブルは、ストップに割り当てられたルート名、ストップの順序、到着時間などの情報をリストします。到着できなかったストップの場合、属性テーブルは問題の原因に関する情報を提供します。
ストップごとに返される属性の説明を以下に示します。
フィールド名 | 説明 |
---|---|
OID | ストップの一意の識別子。この識別子は、サービスによって自動生成されます。 |
ストップ名 | ルートによって訪問されたストップの名前。 |
RouteName | ストップが割り当てられるルートの名前。 ツールの実行時に同じルート名を持つ複数の入力ストップはグループ化され、1 つのルートで移動し、ルートにその名前が割り当てられます。入力ストップに複数のルート名が存在する場合、ツールはルート名ごとに 1 つのルートを割り当てて、複数のルートを出力できます。 名前が存在しなければ、すべてのストップが同じルートに属します。 |
シーケンス | 割り当てられたルートを訪問するストップの順序。[RouteName] フィールドにリストされます。 |
TimeWindowStart | ルートがストップを訪問できる最も早い時刻。このフィールドの値は、入力ストップの [TimeWindowStart] フィールドからコピーされます。 |
TimeWindowEnd | ルートがストップを訪問できる最も遅い時刻。このフィールドの値は、入力ストップの [TimeWindowEnd] フィールドからコピーされます。 |
ArriveCurbApproach | 車両がストップに到着するときに、アプローチを車両のどちら側にするかを示します。 |
DepartCurbApproach | 車両がストップから出発するときに、アプローチを車両のどちら側にするかを示します。 |
LocationType | ストップ タイプを示します。このフィールドの値は、入力ストップの [LocationType] フィールドからコピーされます。 |
CurbApproach | 車両がストップに到着する方向およびストップから出発する方向。このフィールドの値は、入力ストップの [CurbApproach] フィールドからコピーされます。 |
ステータス | ストップが解析でどのように評価されたかを示します。このフィールドを使用して、ルートに割り当てられなかったストップを判定できます。出力される可能性のある値は次のとおりです。
|
AdditionalTime | このストップを訪問するときの合計ルート所要時間に追加される時間の長さ。このフィールドの値は、入力ストップの [AdditionalTime] フィールドからコピーされます。 このフィールドは、Measurement Units パラメーターの値が時間ベースである場合にのみ含まれます。 |
AdditionalDistance | このストップを訪問するときの合計ルート距離に追加される距離の長さ。このフィールドの値は、入力ストップの [AdditionalDistance] フィールドからコピーされます。 このフィールドは、Measurement Units パラメーターの値が距離ベースである場合にのみ含まれます。 |
Cumul_Minutes | 起点からストップまでのルートの累積所要時間 (分)。ここに報告される値は、ストップまでの累積ルート時間です。これには、このストップおよびそれ以前のストップでの追加の時間が含まれます。 |
ORIG_FID | 入力ストップの ObjectID。このフィールドを使用して、出力ストップから入力ストップ、または入力ストップから出力ストップに属性を結合できます。 |
Cumul_Kilometers | 起点からストップまでのルートの累積距離 (キロメートル)。ここに報告される値は、ストップまでの累積ルート距離です。これには、このストップおよびそれ以前のストップでの追加の距離が含まれます。 |
Cumul_Miles | 起点からストップまでのルートの累積距離 (マイル)。ここに報告される値は、ストップまでの累積ルート距離です。これには、このストップおよびそれ以前のストップでの追加の距離が含まれます。 |
output_route_edges
このパラメーターを使用して、ルートが移動する個別の道路セグメントにアクセスします。
ルート エッジごとに返される属性の説明を以下に示します。
フィールド名 | 説明 |
---|---|
OID | ルート エッジの一意な ID。この識別子は、サービスによって自動生成されます。 |
形状 | ラインの形状を示すジオメトリ フィールド。 |
SourceName | ラインを生成する元になったエッジ ソース フィーチャクラスの名前。 |
SourceOID | 商圏内道路フィーチャの ObjectID。このフィールドの値を集計すると、特定の道路フィーチャがすべてのルートに含まれる回数など、役に立つ情報を得ることができます。 |
RouteEdgeID | 道路フィーチャを構成するエッジを表す ID。1 つの道路フィーチャには複数のエッジが存在する可能性があるため、[SourceOID] フィールドを使用して商圏内道路を一意に識別したり、[RouteEdgeID] フィールドを使用して商圏内道路フィーチャ内にあるエッジを一意に識別することができます。 |
FromPosition | 基礎となる道路フィーチャをデジタイズした方向を基準にして、出力 RouteEdges フィーチャが始まる場所を指定します。
|
ToPosition | 基礎となる道路フィーチャをデジタイズした方向を基準にして、出力 RouteEdges フィーチャが始まる場所を指定します。
|
RouteID | エッジを通過したルートを一意に識別します。[RouteID] の値は、output_routes フィーチャクラスの ObjectID 値に対応します。 |
Attr_Minutes | 基礎となる道路フィーチャの通過部分の移動時間 (分)。 |
Attr_Miles | 基礎となる道路フィーチャの通過部分の長さ (マイル)。 |
Attr_Kilometers | 基礎となる道路フィーチャの通過部分の長さ (キロメートル)。 |
Cumul_Minutes | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの移動時間 (分)。 |
Cumul_Miles | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの長さ (マイル)。 |
Cumul_Kilometers | この基礎となる道路フィーチャの通過部分の始点から終点までのルートの長さ (キロメートル)。 |
Attr_[Soft Restriction Attribute Name] | 通過したエッジが、このフィールド名で参照されているソフトな規制属性を使用したかどうかを指定します。
たとえば、解析が [Avoid Toll Roads] というソフトな規制を使用して実行された場合、このソフトな規制に [Attr_Avoid_Toll_Roads] というフィールドが作成されます。このフィールドの値が 1 の場合、ルート内の有料道路を表します。 |
Shape_Length | ルート ジオメトリに対して指定された空間参照の単位でのルート エッジの長さ。 |
solve_succeeded
このパラメーターを使用して、サービスがルートを正常に検出できたかどうかを確認します。失敗に関するエラー メッセージは、ジョブのステータスを取得するリクエストを作成することによって取得できます。