24.20 SDO_LRS.GET_MEASURE

書式

SDO_LRS.GET_MEASURE(
     point        IN SDO_GEOMETRY 
     [, dim_array IN SDO_DIM_ARRAY] 
     ) RETURN NUMBER;

説明

LRS点のメジャーを戻します。

パラメータ

point

メジャーを戻す点を指定します。

dim_array

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

使用上の注意

このファンクションは、LRS点のメジャーを戻します。

pointが無効な場合、「invalid LRS point」例外が発生します。

このファンクションをSDO_LRS.PROJECT_PTと比較すると、このファンクションは、ジオメトリ・セグメント上にあるとはかぎらない点でも入力値として受け入れますが、戻すのはメジャー値ではなく、ジオメトリ・セグメント上の点です。SDO_LRS.GET_MEASUREファンクションを使用して、SDO_LRS.PROJECT_PTによって戻される投影点のメジャーを戻す例を次に示します。

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

例

次の例では、投影点のメジャーを戻します。この場合、投影の結果できる点はセグメントの開始位置から9単位です。

SELECT SDO_LRS.GET_MEASURE(
   SDO_LRS.PROJECT_PT(a.route_geometry, m.diminfo,
    SDO_GEOMETRY(3001, NULL, NULL,
       SDO_ELEM_INFO_ARRAY(1, 1, 1),
       SDO_ORDINATE_ARRAY(9, 3, NULL)) ),
   m.diminfo )
   FROM lrs_routes a, user_sdo_geom_metadata m
   WHERE m.table_name = 'LRS_ROUTES' AND m.column_name = 'ROUTE_GEOMETRY'
       AND a.route_id = 1;

SDO_LRS.GET_MEASURE(SDO_LRS.PROJECT_PT(A.ROUTE_GEOMETRY,M.DIMINFO,SDO_GEOM
--------------------------------------------------------------------------------
                                                                               9