書式
SDO_SAM.TILED_BINS( l1 IN NUMBER, u1 IN NUMBER, l2 IN NUMBER, u2 IN NUMBER, tiling_level IN NUMBER DEFAULT NULL, srid IN NUMBER DEFAULT NULL, xdivs IN NUMBER DEFAULT NULL, ydivs IN NUMBER DEFAULT NULL ) RETURN SDO_REGIONSET;
説明
2次元空間を四角形処理し、その四角形に対応するジオメトリを戻します。
パラメータ
最初の次元のエクステントの下限を指定します。
最初の次元のエクステントの上限を指定します。
第2の次元のエクステントの下限を指定します。
第2の次元のエクステントの上限を指定します。
指定したエクステントの四角形処理に使用するレベルを指定します。このパラメータを指定すると、各ディメンションのエクステントは、2^tiling_level
個の要素に分割され、結果として最大で4×tiling_level
の四角形が作成されます。(このパラメータ、またはxdivs
パラメータとydivs
パラメータの組合せのいずれかを指定します。)
戻される四角形ジオメトリの座標系に含まれるSRID値を指定します。
1つ目の次元のエクステントを何回分割するかを指定します(分割後の要素の合計数はxdivs
+ 1)。たとえば、xdivs
を10に指定すると、1つ目の次元のエクステントは11の要素に分割されます。
2つ目の次元のエクステントを何回分割するかを指定します(分割後の要素の合計数はydivs
+ 1)。たとえば、ydivs
を10に指定すると、2つ目の次元のエクステントは11の要素に分割されます。
使用上の注意
tiling_level
パラメータ、またはxdivs
パラメータとydivs
パラメータの両方を指定する必要があります。これらの3つのパラメータをすべて指定した場合、tiling_level
パラメータは無視され、xdivs
パラメータとydivs
パラメータが使用されます。
xdivs
パラメータとydivs
パラメータを指定した場合、戻されるグリッド(四角形)の合計数は、(xdivs+1)×(ydivs+1)
です。
このファンクションは、SDO_REGIONSET型のオブジェクトを戻します。SDO_REGIONSETオブジェクト型は、次のとおり定義されます。
TABLE OF SDO_REGION
SDO_REGIONオブジェクト型は、次のとおり定義されます。
Name Null? Type ----------------------------------------- -------- ---------------------------- ID NUMBER GEOMETRY MDSYS.SDO_GEOMETRY
例
次の例では、標準的な緯度と経度の座標系(SRID 8307)を使用して、四角形処理レベル1で地表面全体の四角形処理を行います。結果として戻されるSDO_REGIONSETオブジェクトには、4つのSDO_REGIONオブジェクト(四角形ごとに1つのオブジェクト)が含まれます。
SELECT * FROM TABLE(sdo_sam.tiled_bins(-180, 180, -90, 90, 1, 8307)) ORDER BY id; ID ---------- GEOMETRY(SDO_GTYPE, SDO_SRID, SDO_POINT(X, Y, Z), SDO_ELEM_INFO, SDO_ORDINATES) -------------------------------------------------------------------------------- 0 SDO_GEOMETRY(2003, 8307, NULL, SDO_ELEM_INFO_ARRAY(1, 1003, 3), SDO_ORDINATE_ARR AY(-180, -90, 0, 0)) 1 SDO_GEOMETRY(2003, 8307, NULL, SDO_ELEM_INFO_ARRAY(1, 1003, 3), SDO_ORDINATE_ARR AY(-180, 0, 0, 90)) 2 SDO_GEOMETRY(2003, 8307, NULL, SDO_ELEM_INFO_ARRAY(1, 1003, 3), SDO_ORDINATE_ARR AY(0, -90, 180, 0)) 3 SDO_GEOMETRY(2003, 8307, NULL, SDO_ELEM_INFO_ARRAY(1, 1003, 3), SDO_ORDINATE_ARR AY(0, 0, 180, 90)) 4 rows selected.