26 SDO_LRSパッケージ(線形参照システム)

MDSYS.SDO_LRSパッケージには、線形参照要素の作成、変更、問合せおよび変換を行うサブプログラムが含まれています。

これらのサブプログラムによって、データベースの状態が変更されることはありません。多くのLRSサブプログラムはファンクションです。

この章で説明するサブプログラムを使用するには、「線形参照システム」で説明する線形参照システム(LRS)の概念および技術を理解しておく必要があります。

ノート:

3次元ジオメトリに対するSDO_LRSサブプログラムは、Oracle Autonomous Databaseサーバーレス・デプロイメントでOracle JVMが有効になっている場合にのみサポートされます。Oracle JVMを有効にするには、Oracle Autonomous Databaseサーバーレスの使用のOracle Javaの使用で詳細を参照してください。

表26-1に、ジオメトリ・セグメントの作成および編集に関連するサブプログラムを示します。

表26-1 ジオメトリ・セグメントの作成および編集サブプログラム

サブプログラム	説明
SDO_LRS.DEFINE_GEOM_SEGMENT	ジオメトリ・セグメントを定義します。
SDO_LRS.REDEFINE_GEOM_SEGMENT	ジオメトリ・セグメントのすべての形状点のメジャーを開始および終了メジャーに基づいて移入し、開始点と終了点の間で事前に割り当てられたメジャーを上書きします。
SDO_LRS.CLIP_GEOM_SEGMENT	ジオメトリ・セグメント(SDO_LRS.DYNAMIC_SEGMENTのシノニム)をクリップします。
SDO_LRS.DYNAMIC_SEGMENT	ジオメトリ・セグメント(SDO_LRS.CLIP_GEOM_SEGMENTのシノニム)をクリップします。
SDO_LRS.CONCATENATE_GEOM_SEGMENTS	2つのジオメトリ・セグメントを連結して1つのセグメントにします。
SDO_LRS.LRS_INTERSECTION	いずれか、または両方がLRSジオメトリである2つのジオメトリ・オブジェクトで位相的に共通部分(AND演算)となるLRSジオメトリ・オブジェクトを戻します。
SDO_LRS.OFFSET_GEOM_SEGMENT	ジオメトリ・セグメントから指定したオフセットにあるジオメトリ・セグメントを戻します。
SDO_LRS.SPLIT_GEOM_SEGMENT	ジオメトリ・セグメントを2つに分割します。
SDO_LRS.RESET_MEASURE	開始メジャーおよび終了メジャーを含むジオメトリ・セグメントのすべてのメジャーをNULL値に設定し、事前に割り当てられたメジャーを上書きします。
SDO_LRS.SCALE_GEOM_SEGMENT	ジオメトリ・セグメントをメジャーのスケール変更した結果のジオメトリ・オブジェクトを戻します。
SDO_LRS.SET_PT_MEASURE	指定された点のメジャー値を設定します。
SDO_LRS.REVERSE_MEASURE	ジオメトリ・セグメントのメジャー値を反転させて(方向は反転させない)、新しいジオメトリ・セグメントを戻します。
SDO_LRS.TRANSLATE_MEASURE	ジオメトリ・セグメントを変換して、新しいジオメトリ・セグメントを戻します(開始および終了メジャーを指定した値分シフトします)。
SDO_LRS.REVERSE_GEOMETRY	ジオメトリ・セグメントのメジャー値および方向を反転させて、新しいジオメトリ・セグメントを戻します。

表26-2に、ジオメトリ・セグメントの問合せに関連するサブプログラムを示します。

表26-2 ジオメトリ・セグメントの問合せおよび検査サブプログラム

サブプログラム	説明
SDO_LRS.VALID_GEOM_SEGMENT	ジオメトリ・セグメントが有効かどうかを確認します。
SDO_LRS.VALID_LRS_PT	LRS点が有効かどうかを確認します。
SDO_LRS.VALID_MEASURE	メジャーがジオメトリ・セグメントのメジャー範囲内かどうかを確認します。
SDO_LRS.CONNECTED_GEOM_SEGMENTS	2つのジオメトリ・セグメントが空間的に接続しているかどうかを確認します。
SDO_LRS.GEOM_SEGMENT_LENGTH	ジオメトリ・セグメントの長さを戻します。
SDO_LRS.GEOM_SEGMENT_START_PT	ジオメトリ・セグメントの開始点を戻します。
SDO_LRS.GEOM_SEGMENT_END_PT	ジオメトリ・セグメントの終了点を戻します。
SDO_LRS.GEOM_SEGMENT_START_MEASURE	ジオメトリ・セグメントの開始メジャーを戻します。
SDO_LRS.GEOM_SEGMENT_END_MEASURE	ジオメトリ・セグメントの終了メジャーを戻します。
SDO_LRS.GET_MEASURE	LRS点のメジャーを戻します。
SDO_LRS.GET_NEXT_SHAPE_PT	ジオメトリ・セグメント上の指定したメジャー値またはLRS点の次の形状点を戻します。
SDO_LRS.GET_NEXT_SHAPE_PT_MEASURE	ジオメトリ・セグメント上の指定したメジャー値またはLRS点の次の形状点のメジャー値を戻します。
SDO_LRS.GET_PREV_SHAPE_PT	ジオメトリ・セグメント上の指定したメジャー値またはLRS点の前の形状点を戻します。
SDO_LRS.GET_PREV_SHAPE_PT_MEASURE	ジオメトリ・セグメント上の指定したメジャー値またはLRS点の前の形状点のメジャー値を戻します。
SDO_LRS.IS_GEOM_SEGMENT_DEFINED	LRSセグメントが正しく定義されているかどうかを確認します。
SDO_LRS.IS_MEASURE_DECREASING	メジャー値がLRSセグメントの方向に降順である(数値が減少している)かどうかを確認します。
SDO_LRS.IS_MEASURE_INCREASING	メジャー値がLRSセグメントの方向に昇順である(数値が増加している)かどうかを確認します。
SDO_LRS.IS_SHAPE_PT_MEASURE	指定したメジャー値がジオメトリ・セグメント上の形状点に関連付けられているかどうかを確認します。
SDO_LRS.MEASURE_RANGE	ジオメトリ・セグメントのメジャー範囲(開始メジャーと終了メジャーの差)を戻します。
SDO_LRS.MEASURE_TO_PERCENTAGE	ジオメトリ・セグメントのメジャー範囲に対する指定したメジャーの割合(0から100%)を戻します。
SDO_LRS.PERCENTAGE_TO_MEASURE	ジオメトリ・セグメントのメジャー範囲に対する、指定した割合(0から100%)のメジャー値を戻します。
SDO_LRS.LOCATE_PT	ジオメトリ・セグメントの開始位置から指定した距離にある点を戻します。
SDO_LRS.PROJECT_PT	指定した点の投影点を戻します。投影点はジオメトリ・セグメント上にあります。
SDO_LRS.FIND_LRS_DIM_POS	指定されたSDO_GEOMETRY列のSDO_DIM_ARRAY構造内におけるメジャー次元の位置を戻します。
SDO_LRS.FIND_MEASURE	指定した投影点に最も近いセグメント上の点のメジャーを戻します。
SDO_LRS.FIND_OFFSET	点とジオメトリ・セグメント間の符号付きオフセット(最短距離)を戻します。
SDO_LRS.VALIDATE_LRS_GEOMETRY	LRSジオメトリが有効かどうかを確認します。

表26-3に、ジオメトリ・セグメントの変換に関連するサブプログラムを示します。

表26-3 ジオメトリ・セグメントの変換サブプログラム

サブプログラム	説明
SDO_LRS.CONVERT_TO_LRS_DIM_ARRAY	メジャー次元を作成して、標準の次元配列をLRS次元配列に変換します。
SDO_LRS.CONVERT_TO_LRS_GEOM	メジャー情報を追加して、標準のSDO_GEOMETRY線ストリングをLRSジオメトリ・セグメントに変換します。
SDO_LRS.CONVERT_TO_LRS_LAYER	SDO_GEOMETRY型列のすべてのジオメトリ・オブジェクトを、メジャー情報を持たない標準の線ストリング・ジオメトリからメジャー情報を持つLRSジオメトリ・セグメントに変換します。また、メタデータを更新します。
SDO_LRS.CONVERT_TO_STD_DIM_ARRAY	メジャー次元を削除して、LRS次元配列を標準の次元配列に変換します。
SDO_LRS.CONVERT_TO_STD_GEOM	メジャー情報を削除して、LRSジオメトリ・セグメントを標準のSDO_GEOMETRY線ストリングに変換します。
SDO_LRS.CONVERT_TO_STD_LAYER	SDO_GEOMETRY型列のすべてのジオメトリ・オブジェクトを、メジャー情報を持つLRSジオメトリ・セグメントからメジャー情報を持たない標準の線ストリング・ジオメトリに変換します。また、メタデータを更新します。

変換サブプログラムの詳細は、「LRSジオメトリの変換」を参照してください。

この章では、これらのサブプログラムのリファレンス情報をアルファベット順に説明します。

• SDO_LRS.CLIP_GEOM_SEGMENT
  
• SDO_LRS.CONCATENATE_GEOM_SEGMENTS
  
• SDO_LRS.CONNECTED_GEOM_SEGMENTS
  
• SDO_LRS.CONVERT_TO_LRS_DIM_ARRAY
  
• SDO_LRS.CONVERT_TO_LRS_GEOM
  
• SDO_LRS.CONVERT_TO_LRS_LAYER
  
• SDO_LRS.CONVERT_TO_STD_DIM_ARRAY
  
• SDO_LRS.CONVERT_TO_STD_GEOM
  
• SDO_LRS.CONVERT_TO_STD_LAYER
  
• SDO_LRS.DEFINE_GEOM_SEGMENT
  
• SDO_LRS.DYNAMIC_SEGMENT
  
• SDO_LRS.FIND_LRS_DIM_POS
  
• SDO_LRS.FIND_MEASURE
  
• SDO_LRS.FIND_OFFSET
  
• SDO_LRS.GEOM_SEGMENT_END_MEASURE
  
• SDO_LRS.GEOM_SEGMENT_END_PT
  
• SDO_LRS.GEOM_SEGMENT_LENGTH
  
• SDO_LRS.GEOM_SEGMENT_START_MEASURE
  
• SDO_LRS.GEOM_SEGMENT_START_PT
  
• SDO_LRS.GET_MEASURE
  
• SDO_LRS.GET_NEXT_SHAPE_PT
  
• SDO_LRS.GET_NEXT_SHAPE_PT_MEASURE
  
• SDO_LRS.GET_PREV_SHAPE_PT
  
• SDO_LRS.GET_PREV_SHAPE_PT_MEASURE
  
• SDO_LRS.IS_GEOM_SEGMENT_DEFINED
  
• SDO_LRS.IS_MEASURE_DECREASING
  
• SDO_LRS.IS_MEASURE_INCREASING
  
• SDO_LRS.IS_SHAPE_PT_MEASURE
  
• SDO_LRS.LOCATE_PT
  
• SDO_LRS.LRS_INTERSECTION
  
• SDO_LRS.MEASURE_RANGE
  
• SDO_LRS.MEASURE_TO_PERCENTAGE
  
• SDO_LRS.OFFSET_GEOM_SEGMENT
  
• SDO_LRS.PERCENTAGE_TO_MEASURE
  
• SDO_LRS.PROJECT_PT
  
• SDO_LRS.REDEFINE_GEOM_SEGMENT
  
• SDO_LRS.RESET_MEASURE
  
• SDO_LRS.REVERSE_GEOMETRY
  
• SDO_LRS.REVERSE_MEASURE
  
• SDO_LRS.SCALE_GEOM_SEGMENT
  
• SDO_LRS.SET_PT_MEASURE
  
• SDO_LRS.SPLIT_GEOM_SEGMENT
  
• SDO_LRS.TRANSLATE_MEASURE
  
• SDO_LRS.VALID_GEOM_SEGMENT
  
• SDO_LRS.VALID_LRS_PT
  
• SDO_LRS.VALID_MEASURE
  
• SDO_LRS.VALIDATE_LRS_GEOMETRY