23.22 SDO_GEOM.SDO_MBC_RADIUS

注意:

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

書式

SDO_GEOM.SDO_MBC_RADIUS(     
  geom  IN SDO_GEOMETRY,      
  dim   IN SDO_DIM_ARRAY,      
  unit  IN VARCHAR2 DEFAULT NULL      
) RETURN NUMBER;

または

SDO_GEOM.SDO_MBC_RADIUS(     
  geom  IN SDO_GEOMETRY,      
  tol   IN NUMBER,      
  unit  IN VARCHAR2 DEFAULT NULL      
) RETURN NUMBER;

説明

ジオメトリ・オブジェクトの最小境界円(MBC)の半径の長さを戻します。

パラメータ

geom

ジオメトリ・オブジェクト。

dim

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

tol

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

unit

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

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

使用上の注意

最小境界円は、ジオメトリを最小に囲む円です。

ジオメトリ(geom)に円弧要素が含まれる場合、このファンクションは、各円弧要素の最小境界矩形(MBR)を計算し、これらのMBRを使用してジオメトリの最小境界円を計算します。このため、たとえば入力ジオメトリが円の場合、計算されるMBCの半径の長さは入力ジオメトリの半径の長さより大きくなります。

例

次の例は、cola_aの最小境界円の半径の長さを戻します。(例では、「空間データの挿入、索引付けおよび問合せの例」の定義およびデータを使用しています。)

-- Return the MBC radius of cola_a.
SELECT c.name, SDO_GEOM.SDO_MBC_RADIUS(c.shape, 0.005) FROM cola_markets c
  WHERE c.name = 'cola_a';
 
NAME                             SDO_GEOM.SDO_MBC_RADIUS(C.SHAPE,0.005)         
-------------------------------- --------------------------------------         
cola_a                                                       3.60555128