23.12 SDO_GEOM.SDO_DIAMETER_LINE

注意:

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

書式

SDO_GEOM.SDO_DIAMETER_LINE(     
  geom  IN SDO_GEOMETRY,      
  dim   IN SDO_DIM_ARRAY      
) RETURN NUMBER;

または

SDO_GEOM.SDO_DIAMETER_LINE(     
  geom  IN SDO_GEOMETRY,      
  tol   IN NUMBER       
) RETURN NUMBER;

説明

ジオメトリ・オブジェクトの直径の長さを反映する線ストリング・ジオメトリを戻します。

パラメータ

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

使用上の注意

このファンクションは、円および円以外のジオメトリ・オブジェクトに使用できます。入力ジオメトリに曲線が含まれている必要はありません。

戻される直径の長さは、ジオメトリ・オブジェクトの2つの点の間の最大距離です。(diameterの正式な定義は、大学レベルの数学の教科書またはその他の適切なリファレンス・ソースを参照してください。)

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

点ジオメトリが指定された場合、ファンクションは0 (ゼロ)を戻します。

例

次の例では、COLA_MARKETS表に格納されている各ジオメトリ・オブジェクトの直径の長さを反映する線ストリングを戻します。(例では、「空間データの挿入、索引付けおよび問合せの例」の定義およびデータを使用しています。)

SELECT name, SDO_GEOM.SDO_DIAMETER_LINE(shape, 0.005)
  FROM cola_markets;
 
NAME                                                                            
--------------------------------                                                
SDO_GEOM.SDO_DIAMETER_LINE(SHAPE,0.005)(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z),
--------------------------------------------------------------------------------
cola_a                                                                          
SDO_GEOMETRY(2002, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 2, 1), SDO_ORDINATE_ARRAY(
1, 1, 5, 7))                                                                    
                                                                                
cola_b                                                                          
SDO_GEOMETRY(2002, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 2, 1), SDO_ORDINATE_ARRAY(
8, 1, 5, 7))                                                                    
                                                                                
cola_c                                                                          
SDO_GEOMETRY(2002, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 2, 1), SDO_ORDINATE_ARRAY(
3, 3, 6, 5))                                                                    
                                                                                
cola_d                                                                          
SDO_GEOMETRY(2002, NULL, NULL, SDO_ELEM_INFO_ARRAY(1, 2, 1), SDO_ORDINATE_ARRAY(
8, 7, 8, 11))