ルートのアペンド (Append Routes) (Location Referencing ツール)
サマリー
入力ポリライン レイヤーから LRS ネットワークにルートを追加します。
注意:
ターゲット レイヤーがフィーチャ サービス レイヤーの場合は、検証結果が ArcGIS Server ディレクトリー内のファイルに書き込まれます。 このファイルはデフォルトで 10 分後に自動的にクリーン アップされますが、この時間は、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションにこれらの検証を書き込むには十分でない場合があります。 大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをお勧めします。 この設定を調整するには、ArcGIS Server Manager でサーバー ディレクトリーを編集します。
使用法
このツールを実行するには、LRS データセットが必要です。
このツールは、既存の中心線を検討 パラメーターがオンの場合に、既存の中心線にルートを付加できます。
既存の中心線を考慮しない場合、このツールはターゲットの LRS データセットに中心線を作成したり、ターゲットの LRS ネットワークにルートを作成します。
既存の中心線を考慮する場合、このツールは、ジオメトリーがソース ルートと正確に一致するターゲット LRS データセットの既存の中央線とルートを関連付けます。 ルートに追加する中心線に中心線 ID が含まれていない場合は作成され、中心線シーケンス レコードが追加されます。 ルートを追加する場所に中央線 ID がすでに存在する場合、追加されるルート ID で、ルートの既存の中心線シーケンス レコードが更新されます。
既存の中心線を検討 パラメーターがオンの場合、次の条件ではエラーとなり、ソース ルートを付加するには、これらを解決する必要があります:
ルート フィーチャを追加する際に、中心線を分割する必要があります。
中心線とルートの x、y および z ジオメトリーが一致しません。
中心線が部分一致しています (たとえば、中心線の一部が x、y および z 許容値の範囲外である場合)。
追加されたルートで、1 つ以上の中心線全体がジオメトリーと一致しているが、中心線が存在しない場所があります。
オーバーラップする中心線が検出されます。
追加されたルートに一致する中心線が存在しません。
ソース ルートまたは既存の中心線の長さがゼロまたはほぼゼロであるため、クラスタリング処理によってジオメトリーにギャップが生じます。 クラスタリング処理で、2 つのポイント間の距離が次の値以下である場合、この 2 つのポイントはまとめてスナップされます。
\(1.01 \space * \space sqrt(2) \space * \space (2 \space * \space tolerance \space + \space 2 \space * \space resolution)\)
クラスタリングの詳細については、「フィーチャクラスの基礎」をご参照ください。
出力ルートには、入力ポリラインの頂点の x、y、z 値が含まれますが、m 値は追加されません。
ルートを追加する前に、基となる LRS ネットワーク フィーチャクラス内で、フィールドのマッピングに使用する新しいフィールドを作成します。
入力ポリライン フィーチャクラスとターゲット LRS ネットワークの空間参照、XY 座標精度、および XY 許容値は一致している必要があります。
ツールが実行されたことを示すテキスト ファイルがローカルに書き込まれ、このログには検証に失敗したルートに関する情報が含まれます。 ツール メッセージには、テキスト ファイルの場所 (一時ディレクトリー) が記載されています。
ルートの部分読み込みを許可 パラメーターがオンになっている場合、以下がサポートされます:
特定のソース ルートが検証に失敗した場合でも、有効なソース ルートはターゲット LRS ネットワークに追加されます。
このツールは、検証に失敗したソース ルートが含まれているフィーチャクラスを返します。 テキスト ファイル内の情報を用いて、問題のあるソース ルートを修正できます。
注意:
作成されたフィーチャクラスは一時的なものであり、ArcGIS Pro を閉じると削除されます。 フィーチャクラスのコピーを作成するには、コンテンツ ウィンドウでレイヤーを右クリックした後、データ > フィーチャのエクスポート の順にクリックするか、フィーチャのエクスポート ツールを使用します。
このツールは、ルートが追加され、中心線フィーチャが作成された変更済み LRS ネットワークを出力します。
競合の防止を有効にした場合は、次の処理が実行されます。
新しいルートを追加する場合、そのルートのロックは取得されません。
ルート ID による廃止 や ルート ID による置換 などのその他の読み込みタイプの場合、ロックが取得できる場合は自動的に取得されます。
ロックが取得できない場合、ツールは実行されず、問題となっているロックのテキスト ファイルが提示されます。
デフォルト バージョンで作業している場合は、このツールの実行が正常に終了した時点で、取得されたロックが自動的に解除されます。
指定バージョンで作業している場合は、このツールの実行が完了した後も、取得されたロックは On Post 解除可能ステータスのまま維持されます。 ロックを解除するには、バージョンをポストまたは削除します。
指定バージョンで作業している場合に、中断によってこのツールの処理が取り消されると、取得されたロックは解除可能ステータスが Yes のまま維持されます。 ロックの所有者はロックを解除できます。
ArcGIS Pipeline Referencing でのロックの解除または ArcGIS Roads and Highways でのロックの解除の詳細
ArcGIS Pipeline Referencing での競合の防止または ArcGIS Roads and Highways での競合の防止の詳細
入力ポリライン フィーチャクラスに曲線が含まれる場合、曲線に頂点が挿入されます。
ArcGIS Pipeline Referencing の曲線または ArcGIS Roads and Highways の曲線の詳細
ターゲット LRS ネットワークがマルチフィールド ルート ID をサポートするライン ネットワークとして構成されている場合、ルートを追加する際に以下のパラメーターは必要ありません。
ルート名フィールド
ライン名フィールド
読み込みタイプ パラメーターの 追加 パラメーター値を使用して新しいルートを付加する場合、ターゲット LRS ネットワークにルート名が構成されていると、そのルート名を使用してルートを付加できます。 ルート ID が NULL の場合、追加されたルートに対してルート ID が生成されます。
ツールは、ライン順序値が 0 より大きく、ライン内の流れと方向に対して 100 刻みで増分していることを確認します。 ライン順序値に不正がある場合、ツールは失敗します。 出力テキスト ファイルは、不正なライン順序をエラーとして報告します。 これらのエラーが修正されると、ツールは正常に実行されます。
ツールは、ルートが読み込まれる LRS ネットワークに構成されているユーティリティー ネットワークがないか確認します。 ユーティリティー ネットワークが見つかった場合、ルートを付加する際に既存の中心線を考慮し、ジオプロセシング ウィンドウで 既存の中心線を検討 パラメーターは非表示になります。
読み込みタイプ パラメーターが ルート ID による置換 または ルート ID による廃止 に設定され、ソース ルートにターゲット ルートと同じルート名およびルート ID 値が含まれていない場合、このツールは失敗します。
ルート ID による置換 パラメーター値が 読み込みタイプ パラメーターに対して指定された場合、置換されるルートでは、ルートと中心線シーケンス レコードが置換されます。 ルートのキャリブレーション ポイントは削除され、再作成または再読み込みする必要があります。
LRS がアドレス データの管理ソリューションで構成されている場合、既存の中心線を検討 パラメーターはデフォルトでオンになります。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
ソース ルート |
ルートを取得する入力。 入力には、ポリライン フィーチャクラス、シェープファイル、フィーチャ サービス、または LRS ネットワーク フィーチャクラスを指定できます。 |
Feature Layer |
|
LRS ネットワーク |
ルートを読み込むターゲット LRS ネットワーク。 |
Feature Layer |
|
ルート ID フィールド |
LRS ネットワークのルート ID フィールドにマッピングされる入力ポリライン フィーチャクラスのフィールド。 フィールド タイプはターゲット LRS ネットワークの |
Field |
|
ルート名フィールド |
LRS ネットワークのルート名フィールドにマッピングされる入力ポリライン フィーチャクラスのフィールド。 フィールドが文字列フィールドで、フィールドの長さはターゲット ルート名フィールドの長さ以下である必要があります。 |
Field |
|
開始日フィールド (オプション) |
LRS ネットワークの開始日フィールドにマッピングされる入力ポリライン フィーチャクラスのフィールド。 フィールドがマッピングされていない場合、追加されるすべてのルートに、時間の開始を表す NULL 値が指定されます。 |
Field |
|
終了日フィールド (オプション) |
LRS ネットワークの終了日フィールドにマッピングされる入力ポリライン フィーチャクラスのフィールド。 フィールドがマッピングされていない場合、追加されるすべてのルートに、時間の終了を表す NULL 値が指定されます。 |
Field |
|
ライン ID フィールド (オプション) |
LRS ネットワークのライン ID フィールドにマッピングされる入力ポリライン フィーチャクラスのフィールド。 このパラメーターは、ターゲット LRS ネットワークが LRS ライン ネットワークの場合のみ使用されます。 フィールド タイプと長さは、中心線シーケンス テーブルのルート ID フィールド タイプと一致する必要があります。 |
Field |
|
ライン名フィールド (オプション) |
LRS ネットワークのライン名にマッピングされる入力ポリライン フィーチャクラスの文字列フィールド。 このパラメーターは、ターゲット LRS ネットワークが LRS ライン ネットワークの場合のみ使用されます。 |
Field |
|
ライン順序フィールド (オプション) |
LRS ネットワークのライン順序フィールドにマッピングされる入力ポリライン フィーチャクラスの long integer フィールド。 このパラメーターは、ターゲット LRS ネットワークが LRS ライン ネットワークの場合のみ使用されます。 Pipeline Referencing でのライン ネットワークとライン順序または Roads and Highways でのライン ネットワークとライン順序の詳細 |
Field |
|
フィールド マップ (オプション) |
ソース ルート フィールド内の属性情報を入力 LRS ネットワークに転送する方法を制御します。 定義済みのスキーマを含む既存の LRS ネットワークにソース ルートのデータが追加されるため、ターゲット LRS ネットワークにフィールドを追加したり、ターゲット LRS ネットワークからフィールドを削除したりすることはできません。 出力フィールドごとにマージ ルールを設定することもできますが、設定したルールはこのツールで無視されます。 |
Field Mappings |
|
読み込みタイプ (オプション) |
追加されたルートのうち、メジャーまたは一時性のオーバーラップがあり、同じルート ID を持つルートをネットワーク フィーチャクラスに読み込む方法を指定します。
|
String |
|
読み込みフィールド (オプション) |
ルートを読み込むために使用されるフィールドを指定します。
|
String |
|
既存の中心線を検討 (オプション) |
既存の中心線を使用してルートが追加されるかどうかを指定します。
|
Boolean |
|
ルートの部分読み込みを許可 (オプション) |
特定のルートが検証に失敗した場合でも有効なルートは追加するかどうかを指定します。
|
Boolean |
派生した出力
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
LRS ネットワーク |
更新された LRS ネットワーク フィーチャ レイヤー。 |
Feature Layer |
|
出力結果ファイル |
このツールで変更された内容が詳しく記述されたテキスト ファイル。 |
Text File |
|
スキップされたルート |
検証に失敗したソース ルートが含まれているフィーチャクラス。 |
Feature Class |
環境
ライセンス情報
- Basic: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
- Standard: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
- Advanced: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要