24.23 SDO_LRS.GET_PREV_SHAPE_PT

書式

SDO_LRS.GET_PREV_SHAPE_PT(
     geom_segment IN SDO_GEOMETRY, 
     measure      IN NUMBER 
     ) RETURN SDO_GEOMETRY;

または

SDO_LRS.GET_PREV_SHAPE_PT(
     geom_segment IN SDO_GEOMETRY, 
     dim_array    IN SDO_DIM_ARRAY, 
     measure      IN NUMBER 
     ) RETURN SDO_GEOMETRY;

または

SDO_LRS.GET_PREV_SHAPE_PT(
     geom_segment IN SDO_GEOMETRY, 
     point        IN SDO_GEOMETRY 
     ) RETURN SDO_GEOMETRY;

または

SDO_LRS.GET_PREV_SHAPE_PT(
     geom_segment IN SDO_GEOMETRY, 
     dim_array    IN SDO_DIM_ARRAY, 
     point        IN SDO_GEOMETRY 
     ) RETURN SDO_GEOMETRY;

説明

ジオメトリ・セグメント上の指定したメジャー値またはLRS点の前の形状点を戻します。

パラメータ

geom_segment

ジオメトリ・セグメントを指定します。

measure

ジオメトリ・セグメント上の前の形状点を戻すメジャー値を指定します。

point

前の形状点を戻す点を指定します。pointがgeom_segment上にない場合、指定した点に最も近いジオメトリ・セグメント上の点が計算され、その点の前で最も近い形状点が戻されます。

dim_array

geom_segmentに対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。

使用上の注意

measureまたはpointにジオメトリ・セグメントの開始点を指定した場合、NULL値が戻されます。

measureがgeom_segmentに有効な値ではない場合、またはpointが有効なLRS点ではない場合、例外が発生します。

このファンクションは、ジオメトリ・セグメント上の指定したメジャー値またはLRS点の次の形状点を戻すSDO_LRS.GET_NEXT_SHAPE_PTと対照的です。

このファンクションは_3D 形式(SDO_LRS.GET_PREV_SHAPE_PT_3D)が使用可能です。LRSファンクションの3D形式については、「LRSファンクションの3D形式」を参照してください。

例

次の例では、ジオメトリ・セグメントRoute 1上のメジャー14の前にあり、メジャー14に最も近い形状点を戻します。(例では、「LRSファンクションの例」の例の定義を使用しています。)

SELECT SDO_LRS.GET_PREV_SHAPE_PT(a.route_geometry, 14)
   FROM lrs_routes a WHERE a.route_id = 1;

SDO_LRS.GET_PREV_SHAPE_PT(A.ROUTE_GEOMETRY,14)(SDO_GTYPE, SDO_SRID, SDO_POINT(X,
--------------------------------------------------------------------------------
SDO_GEOMETRY(3301, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 1, 1), SDO_ORDINATE_ARRAY(
12, 4, 12))