注意:
この機能は、Oracle Database 12cリリース1 (12.1.0.2)以降で使用可能です。
書式
SDO_GEOM.SDO_DIAMETER( geom IN SDO_GEOMETRY, dim IN SDO_DIM_ARRAY [, unit IN VARCHAR2] ) RETURN NUMBER;
または
SDO_GEOM.SDO_DIAMETER( geom IN SDO_GEOMETRY, tol IN NUMBER [, unit IN VARCHAR2] ) RETURN NUMBER;
説明
ジオメトリ・オブジェクトの直径の長さを戻します。
パラメータ
ジオメトリ・オブジェクト。
geom
に対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。
許容差(「許容差」を参照)。
測定単位(unit=
およびMDSYS.SDO_DIST_UNITS表のSDO_UNIT値を引用符で囲んだ文字列で、'unit=KM'など)を指定します。測定単位の指定の詳細は、「測定単位のサポート」を参照してください。
このパラメータを指定しない場合、データに関連付けられた測定単位が使用されます。測地データの場合、デフォルトの測定単位はmです。
使用上の注意
このファンクションは、円および円以外のジオメトリ・オブジェクトに使用できます。入力ジオメトリに曲線が含まれている必要はありません。
戻される直径の長さは、ジオメトリ・オブジェクトの2つの点の間の最大距離です。(diameterの正式な定義は、大学レベルの数学の教科書またはその他の適切なリファレンス・ソースを参照してください。)
入力ジオメトリは2つ以下の次元を持つことができます。
点ジオメトリが指定された場合、ファンクションは0 (ゼロ)を戻します。
例
次の例では、COLA_MARKETS表に格納されているすべてのジオメトリ・オブジェクトの直径の長さを戻します。(例では、「空間データの挿入、索引付けおよび問合せの例」の定義およびデータを使用しています。)
SELECT name, SDO_GEOM.SDO_DIAMETER(shape, 0.005) Diameter FROM cola_markets; NAME DIAMETER -------------------------------- ---------- cola_a 7.21110255 cola_b 6.70820393 cola_c 3.60555128 cola_d 4