23.18 SDO_GEOM.SDO_MAXDISTANCE

注意:

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

書式

SDO_GEOM.SDO_MAXDISTANCE(     
  geom1  IN SDO_GEOMETRY,      
  dim1   IN SDO_DIM_ARRAY,      
  geom2  IN SDO_GEOMETRY,      
  dim2   IN SDO_DIM_ARRAY       
  [, unit IN VARCHAR2]      
) RETURN NUMBER;

または

SDO_GEOM.SDO_MAXDISTANCE(     
  geom1  IN SDO_GEOMETRY,      
  geom2  IN SDO_GEOMETRY,      
  tol    IN NUMBER       
  [, unit IN VARCHAR2]      
) RETURN NUMBER;

説明

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

パラメータ

geom1

geom2からの距離を計算するジオメトリ・オブジェクトを指定します。

dim1

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

geom2

geom1からの距離を計算するジオメトリ・オブジェクトを指定します。

dim2

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

unit

測定単位(unit=およびMDSYS.SDO_DIST_UNITS表のSDO_UNIT値を引用符で囲んだ文字列で、'unit=KM'など)を指定します。測定単位の指定の詳細は、「測定単位のサポート」を参照してください。

このパラメータを指定しない場合、データに関連付けられた測定単位が使用されます。

tol

許容差(「許容差」を参照)。

使用上の注意

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

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

例

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

SELECT SDO_GEOM.SDO_MAXDISTANCE(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(C_B.SHAPE,C_D.SHAPE,0.005)                        
---------------------------------------------------                        
                                         10.5440037