FindClosestFacilities からの出力

このサービスは、正常に実行されると、インシデントと選択した施設の間の最適なルートとルート案内、および解析が成功したかどうかを示すステータスを、次の出力パラメーターを使用して返します。

output_closest_facilities

この出力パラメーターを使用して、インシデントに最も近い施設にアクセスできます。施設の位置および対応する入力施設からの属性情報が提供されます。

ルートごとに返されるフィールドの説明を以下に示します。

フィールド名	説明
OID	ルートの一意な ID。この識別子は、サービスによって自動生成されます。
FacilityOID	出力施設によって表される入力施設の ObjectID 値。このフィールドは、多くの場合、入力施設からの情報を結合するために使用されます。

output_routes

このパラメーターを使用して、施設とインシデントの間に生成されたルートにアクセスします。route_shape パラメーターおよび route_line_simplification_tolerance パラメーターは、出力ルートの形状に大きな影響を与えます。ルート ジオメトリは、env:outSR パラメーターで指定された空間参照で返されます。

ルートごとに返されるフィールドの説明を以下に示します。

フィールド名	説明
OID	ルートの一意な ID。この識別子は、サービスによって自動生成されます。
ストップ名	最寄り施設の検出ルートの名前は、関連付けられている施設とインシデントの名前に基づきます。 Facility to Incident パラメーターで travel_direction が指定された場合は、施設名が先頭になります。たとえば「Facility 5—Incident 3」は、ルートが施設 5 からインシデント 3 に向かうことを示します。 Incident to Facility パラメーターで travel_direction が指定された場合は、インシデント名が先頭になります (たとえば、Incident 3—Facility 5)。
FacilityID	ルートが訪れる、施設の一意な ID。facilities パラメーターを指定するときに ID 属性を含めた場合、FacilityID 値は、ID 属性の値と同じになります。そうでない場合、FacilityID には、自動生成された識別子が格納されます。
FacilityOID	ルートの生成に使用される入力施設の ObjectID 値。このフィールドは、多くの場合、施設からの情報をルートに結合するために使用されます。
FacilityRank	関連付けられたインシデントに対して検索されたすべての施設の間でのランク付け (最も近い施設はランク 1)。
FacilityCurbApproach	施設に到着したとき、または施設から出発するときに、施設が車両のどちら側になるかを示します。値が 1 の場合は車両の右側、2 の場合は車両の左側です。
IncidentID	ルートが訪れる、インシデントの一意な ID。incidents パラメーターを指定するときに ID 属性を含めた場合、IncidentID 値は、ID 属性の値と同じになります。そうでない場合、IncidentID には、自動生成された識別子が格納されます。
IncidentOID	ルートの生成に使用される入力インシデントの ObjectID 値。このフィールドは、多くの場合、インシデントからの情報をルートに結合するために使用されます。
IncidentCurbApproach	インシデントに到着したとき、またはインシデントから出発するときに、インシデントが車両のどちら側になるかを示します。値が 1 の場合は車両の右側、値が 2 の場合は車両の左側です。
Shape_Length	ルート ジオメトリに対して指定された空間参照の単位でのルートの長さ。env:outSR パラメーターが指定されない場合、この長さはデフォルトで度 (10 進) 単位でレポートされます。
Total_Minutes	施設とインシデントの間のルートの累積移動時間 (分)。
Total_Miles	施設とインシデントの間のルートの累積移動距離 (マイル)。
Total_Kilometers	施設とインシデントの間のルートの累積移動距離 (キロメートル)。
StartTime	ルートの開始時刻。最初のストップでの現地時間として報告されます。
EndTime	ルートの終了時刻。最後のストップでの現地時間として報告されます。
StartTimeUTC	UTC (協定世界時) でのルートの開始時刻。
EndTimeUTC	UTC (協定世界時) でのルートの終了時刻。

注意:

measurement_units パラメーターが Miles、Kilometers、または Minutes のいずれとも等しくない場合、Total_[MeasurementUnits] という名前のフィールドが追加されます。たとえば、measurement_units パラメーターが Meters と指定された場合、output_routes パラメーターには、Total_Meters、Total_Miles、Total_Kilometers、および Total_Minutes の各フィールドが含まれます。

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 テーブルの整数です。 走行タイプ 値 説明 0 Unknown 1 ストップに到着 2 真っすぐ進む 3 左方向に進みます 4 右方向に進みます 5 左に曲がります 6 右に曲がります 7 左折 8 右折 9 U ターンする 10 フェリーに乗る 11 ロータリーに入る 12 高速道路へ合流 13 高速道路を出る 14 別の高速道路に進む 15 分岐点で中心車線を維持 16 分岐点で左車線を維持 17 分岐点で右車線を維持 18 ストップを出発 19 移動計画アイテム 20 フェリーの終点 21 右側ランプ 22 左側ランプ 23 左に曲がってからすぐに右に曲がる 24 右に曲がってからすぐに左に曲がる 25 右に曲がってからすぐに右に曲がる 26 左に曲がってからすぐに左に曲がる ルート案内文字列タイプ 値 説明 0 一般のルート案内文字列タイプ 1 出発のルート案内文字列タイプ 2 到着のルート案内文字列タイプ 3 長さのルート案内文字列タイプ 4 時間のルート案内文字列タイプ 5 時間サマリーのルート案内文字列タイプ 6 タイム ウィンドウのルート案内文字列タイプ 7 超過時間のルート案内文字列タイプ 8 待機時間のルート案内文字列タイプ 9 サービス時間のルート案内文字列タイプ 10 推定到着時間のルート案内文字列タイプ 11 累積長のルート案内文字列タイプ 12 道路名のルート案内文字列タイプ 13 代替道路名のルート案内文字列タイプ 14 分岐標識情報のルート案内文字列タイプ 15 方向標識情報のルート案内文字列タイプ 16 交差道路名のルート案内文字列タイプ 17 出口番号標識のルート案内文字列タイプ
SubItemType	Type フィールドが Directions String Types テーブルの整数または Maneuver Types テーブルの整数のいずれを参照するかを指定します。 SubItemType 値が 1 の場合、Type は Maneuver Types テーブルの値を参照します。 SubItemType 値が 2 の場合、Type は Directions String Types テーブルの値を参照します。
Text	テキストによるルート案内の説明です。
ElaspsedTime	現在のルート案内が開始してから次のルート案内が開始するまで、または最後のルート案内が終了するまでの経過時間 (分)。
DriveDistance	現在のルート案内が発生した場所から次のルート案内が発生する場所まで、または最後のルート案内が終了する場所までの距離。この値の単位は、distance_units パラメーターで指定されます。 次のルート案内が開始する場所と同じ場所で発生するルート案内の場合、値は 0 です。たとえば、ルートの開始でのルート案内テキストの場合、DriveDistance は 0 です。
Shape_Length	ルートに対して指定された空間参照の単位でのルート案内フィーチャの長さ。env:outSR パラメーターが指定されない場合、この長さはデフォルトで度 (10 進) 単位でレポートされます。

solve_succeeded

このパラメーターを使用して、サービスがルートを正常に検出できたかどうかを確認します。失敗に関するエラー メッセージは、ジョブのステータスを取得するリクエストを作成することによって取得できます。