24.32 SDO_LRS.MEASURE_TO_PERCENTAGE

書式

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

または

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

説明

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

パラメータ

geom_segment

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

dim_array

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

measure

メジャー値を指定します。このファンクションは、メジャー範囲に対するメジャー値の割合を戻します。

使用上の注意

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

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

geom_segmentまたはmeasureが無効な場合、例外が発生します。

例

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

SELECT SDO_LRS.MEASURE_TO_PERCENTAGE(a.route_geometry, m.diminfo, 5)
  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.MEASURE_TO_PERCENTAGE(A.ROUTE_GEOMETRY,M.DIMINFO,5)                     
-----------------------------------------------------------                     
                                                 18.5185185