23.19 SDO_GEOM.SDO_MAXDISTANCE_LINE

注意:

この機能は、Oracle Database 12cリリース1 (12.1.0.2)以降で使用可能です。

書式

SDO_GEOM.SDO_MAXDISTANCE_LINE(     
  geom1  IN SDO_GEOMETRY,      
  dim1   IN SDO_DIM_ARRAY,      
  geom2  IN SDO_GEOMETRY,      
  dim2   IN SDO_DIM_ARRAY       
) RETURN SDO_GEOMETRY;

または

SDO_GEOM.SDO_MAXDISTANCE_LINE(     
  geom1  IN SDO_GEOMETRY,      
  geom2  IN SDO_GEOMETRY,      
  tol    IN NUMBER       
) RETURN SDO_GEOMETRY;

説明

2つのジオメトリ・オブジェクト間の最大距離を計算し、最大距離を反映する線ストリング・ジオメトリを戻します。2つのジオメトリ・オブジェクト間の最大距離とは、それらのオブジェクトにある点またはセグメントのペアの最長距離です。戻されるジオメトリは、点またはセグメントのこの最長ペア間の直線です。

パラメータ

geom1: geom2からの距離を計算するジオメトリ・オブジェクトを指定します。
dim1: geom1に対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。
geom2: geom1からの距離を計算するジオメトリ・オブジェクトを指定します。
dim2: geom2に対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。
tol: 許容差(「許容差」を参照)。

使用上の注意

geom1およびgeom2が異なる座標系に基づく場合、例外が発生します。

入力ジオメトリは2つ以下の次元を持つことができます。

例

次の例では、cola_bおよびcola_d間の最大距離を反映する線ストリングが戻されます。(例では、「空間データの挿入、索引付けおよび問合せの例」の定義およびデータを使用しています。)

SELECT SDO_GEOM.SDO_MAXDISTANCE_LINE(c_b.shape, c_d.shape, 0.005)
  FROM cola_markets c_b, cola_markets c_d
  WHERE c_b.name = 'cola_b' AND c_d.name = 'cola_d';
 
SDO_GEOM.SDO_MAXDISTANCE_LINE(C_B.SHAPE,C_D.SHAPE,0.005)(SDO_GTYPE, SDO_SRID, SD
--------------------------------------------------------------------------------
SDO_GEOMETRY(2002, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 2, 1), SDO_ORDINATE_ARRAY(
5, 1, 8.70224688, 10.8726584))