書式
SDO_LRS.GET_PREV_SHAPE_PT_MEASURE( geom_segment IN SDO_GEOMETRY, measure IN NUMBER ) RETURN NUMBER;
または
SDO_LRS.GET_PREV_SHAPE_PT_MEASURE( geom_segment IN SDO_GEOMETRY, dim_array IN SDO_DIM_ARRAY, measure IN NUMBER ) RETURN NUMBER;
または
SDO_LRS.GET_PREV_SHAPE_PT_MEASURE( geom_segment IN SDO_GEOMETRY, point IN SDO_GEOMETRY ) RETURN NUMBER;
または
SDO_LRS.GET_PREV_SHAPE_PT_MEASURE( geom_segment IN SDO_GEOMETRY, dim_array IN SDO_DIM_ARRAY, point IN SDO_GEOMETRY ) RETURN NUMBER;
説明
ジオメトリ・セグメント上の指定したメジャー値またはLRS点の前の形状点のメジャー値を戻します。
パラメータ
ジオメトリ・セグメントを指定します。
ジオメトリ・セグメント上の前の形状点のメジャー値を戻すメジャー値を指定します。
前の形状点のメジャー値を戻す点を指定します。point
がgeom_segment
上にない場合、指定した点に最も近いジオメトリ・セグメント上の点が計算され、その点の前で最も近い形状点のメジャー値が戻されます。
geom_segment
に対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。
使用上の注意
measure
またはpoint
にジオメトリ・セグメントの開始点を指定した場合、NULL値が戻されます。
measure
がgeom_segment
に有効な値ではない場合、またはpoint
が有効なLRS点ではない場合、例外が発生します。
このファンクションは、ジオメトリ・セグメント上の指定したメジャー値またはLRS点の次の形状点のメジャー値を戻すSDO_LRS.GET_NEXT_SHAPE_PT_MEASUREと対照的です。
このファンクションは_3D 形式(SDO_LRS.GET_PREV_SHAPE_PT_MEASURE_3D)が使用可能です。LRSファンクションの3D形式については、「LRSファンクションの3D形式」を参照してください。
例
次の例では、ジオメトリ・セグメントRoute 1上のメジャー14の前にあり、メジャー14に最も近い形状点のメジャー値を戻します。(例では、「LRSファンクションの例」の例の定義を使用しています。)
SELECT SDO_LRS.GET_PREV_SHAPE_PT_MEASURE(a.route_geometry, 14) FROM lrs_routes a WHERE a.route_id = 1; SDO_LRS.GET_PREV_SHAPE_PT_MEASURE(A.ROUTE_GEOMETRY,14) ------------------------------------------------------ 12