24.34 SDO_LRS.PERCENTAGE_TO_MEASURE

書式

SDO_LRS.PERCENTAGE_TO_MEASURE(
     geom_segment IN SDO_GEOMETRY, 
     percentage   IN NUMBER 
     ) RETURN NUMBER;

または

SDO_LRS.PERCENTAGE_TO_MEASURE(
     geom_segment IN SDO_GEOMETRY, 
     dim_array    IN SDO_DIM_ARRAY, 
     percentage   IN NUMBER 
     ) RETURN NUMBER;

説明

ジオメトリ・セグメントのメジャー範囲に対する、指定した割合(0から100%)のメジャー値を戻します。

パラメータ

geom_segment

線形フィーチャの地図的表現を指定します。

dim_array

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

percentage

割合の値を指定します。0から100の範囲で指定する必要があります。このファンクションは、このメジャー範囲の割合に対応するメジャー値を戻します。

使用上の注意

このファンクションは、このメジャー範囲の指定した割合に対応するメジャー値を戻します。(メジャー範囲は終了メジャーから開始メジャーを引いた値です。)たとえば、geom_segmentのメジャー範囲が50でpercentageが40の場合、ファンクションは20を戻します(50の40%は20)。

このファンクションは、メジャーに対応する割合の値を戻すSDO_LRS.MEASURE_TO_PERCENTAGEファンクションとは逆に動作します。

geom_segmentに無効なジオメトリ・タイプまたは次元が含まれる場合、またはpercentageが0から100の範囲外の場合、例外が発生します。

例

次の例では、ジオメトリ・セグメントRoute 1のメジャー範囲に対する50%のメジャーを戻します。(例では、「LRSファンクションの例」の例の定義を使用しています。)このセグメントのメジャー範囲は27で、27の50%は13.5です。

SELECT SDO_LRS.PERCENTAGE_TO_MEASURE(a.route_geometry, m.diminfo, 50)
  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.PERCENTAGE_TO_MEASURE(A.ROUTE_GEOMETRY,M.DIMINFO,50)                    
------------------------------------------------------------                    
                                                        13.5