24.5 SDO_LRS.CONVERT_TO_LRS_GEOM

書式

SDO_LRS.CONVERT_TO_LRS_GEOM(
     standard_geom    IN SDO_GEOMETRY 
     [, start_measure IN NUMBER, 
     end_measure      IN NUMBER] 
     ) RETURN SDO_GEOMETRY;

or

SDO_LRS.CONVERT_TO_LRS_GEOM(
     standard_geom    IN SDO_GEOMETRY, 
     dim_array        IN SDO_DIM_ARRAY 
     [, start_measure IN NUMBER, 
     end_measure      IN NUMBER] 
     ) RETURN SDO_GEOMETRY; 

or

SDO_LRS.CONVERT_TO_LRS_GEOM(
     standard_geom    IN SDO_GEOMETRY, 
     m_pos            IN INTEGER 
     [, start_measure IN NUMBER, 
     end_measure      IN NUMBER]   
    ) RETURN SDO_GEOMETRY;

説明

メジャー情報を追加して、標準のSDO_GEOMETRY線ストリングをLRSジオメトリ・セグメントに変換します。

パラメータ

standard_geom

メジャー情報を持たない線ストリング・ジオメトリを指定します。

dim_array

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

m_pos

メジャー次元の位置を指定します。この値には、常に3または4を指定します。デフォルトでは、メジャー次元はSDO_DIM_ARRAYの最後の次元です。

start_measure

ジオメトリ・セグメントの開始点から線形フィーチャの開始点までの距離を指定します。デフォルトは0です。

end_measure

ジオメトリ・セグメントの終了点から線形フィーチャの開始点までの距離を指定します。デフォルトは地図上の長さです(地図上の長さが75で、メジャー単位がマイルの場合は75です)。

使用上の注意

このファンクションは、メジャー情報を持つLRSジオメトリ・セグメントおよびすべての形状点のメジャー情報を戻します。

standard_geom に無効なジオメトリ・タイプまたは次元が含まれるか、m_posが3から4の範囲外であるか、またはstart_measureまたはend_measureが範囲外の場合、例外が発生します。

このファンクションは_3D形式(SDO_LRS.CONVERT_TO_LRS_GEOM_3D)が使用可能です。ただし、SDO_LRS.CONVERT_TO_LRS_GEOM_3Dでは、m_posパラメータを使用できません。LRSファンクションの3D形式については、「LRSファンクションの3D形式」を参照してください。

変換ファンクションの詳細は、「LRSジオメトリの変換」を参照してください。

例

次の例では、ジオメトリ・セグメントRoute 1をLRSフォーマットに変換します。(例では、「LRSファンクションの例」の例の定義を使用しています。)

SELECT SDO_LRS.CONVERT_TO_LRS_GEOM(a.route_geometry, 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.CONVERT_TO_LRS_GEOM(A.ROUTE_GEOMETRY,M.DIMINFO)(SDO_GTYPE, SDO_SRID, SDO
--------------------------------------------------------------------------------
SDO_GEOMETRY(3302, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 2, 1), SDO_ORDINATE_ARRAY(
2, 2, 0, 2, 4, 2, 8, 4, 8, 12, 4, 12, 12, 10, NULL, 8, 10, 22, 5, 14, 27))