Skip to main content

ルートのアペンド (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 ネットワークに構成されているユーティリティー ネットワークがないか確認します。 ユーティリティー ネットワークが見つかった場合、ルートを付加する際に既存の中心線を考慮し、ジオプロセシング ウィンドウで 既存の中心線を検討 パラメーターは非表示になります。

    Pipeline Referencing とユーティリティー ネットワークを一緒に管理する方法の詳細

  • 読み込みタイプ パラメーターが ルート ID による置換 または ルート ID による廃止 に設定され、ソース ルートにターゲット ルートと同じルート名およびルート ID 値が含まれていない場合、このツールは失敗します。

  • ルート ID による置換 パラメーター値が 読み込みタイプ パラメーターに対して指定された場合、置換されるルートでは、ルートと中心線シーケンス レコードが置換されます。 ルートのキャリブレーション ポイントは削除され、再作成または再読み込みする必要があります。

  • LRS がアドレス データの管理ソリューションで構成されている場合、既存の中心線を検討 パラメーターはデフォルトでオンになります。

パラメーター

ラベル 説明 データ タイプ

ソース ルート

ルートを取得する入力。 入力には、ポリライン フィーチャクラス、シェープファイル、フィーチャ サービス、または LRS ネットワーク フィーチャクラスを指定できます。

Feature Layer

LRS ネットワーク

ルートを読み込むターゲット LRS ネットワーク。

Feature Layer

ルート ID フィールド

LRS ネットワークのルート ID フィールドにマッピングされる入力ポリライン フィーチャクラスのフィールド。 フィールド タイプはターゲット LRS ネットワークの RouteID フィールド タイプと一致し、かつ文字列か GUID フィールド タイプである必要があります。 文字列フィールドの場合、フィールドの長さはターゲット RouteID フィールドの長さ以下である必要があります。

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 を持つルートをネットワーク フィーチャクラスに読み込む方法を指定します。

  • 追加追加されたルートはターゲット LRS ネットワークに読み込まれます。 ソース ルート内のルート ID が、同じ一時性を持つターゲット LRS ネットワークにすでに存在する場合、重複ルートとして出力ログに書き込まれるため、読み込み処理を完了する前に修正またはフィルターを行う必要があります。 これがデフォルトです。

  • ルート ID による廃止追加されたルートはターゲット LRS ネットワークに読み込まれ、ターゲット LRS ネットワーク内で追加されたルートと同じルート ID および一時性のオーバーラップを持つルートは破棄されます。 追加されたルートが同じルート ID を持つターゲット ルートと重複する場合は、そのターゲット ルートが削除されます。

  • ルート ID による置換追加されたルートはターゲット LRS ネットワークに読み込まれ、ターゲット LRS ネットワーク内で追加されたルートと同じルート ID を持つルートは削除されます。

String

読み込みフィールド

(オプション)

ルートを読み込むために使用されるフィールドを指定します。

  • ルート IDルートは、ルート ID フィールドを使用して読み込まれます。 これがデフォルトです。

  • ルート名ルートは、ルート名フィールドを使用して読み込まれます。 このオプションは、読み込みタイプ パラメーターが 追加 に設定されている場合に、LRS ネットワークでルート名が構成されているネットワークでのみ使用できます。

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) が必要