| Oracle® Fusion Middleware Oracle CQLデータ・カートリッジによるアプリケーションの開発 12c リリース(12.2.1.1.0) E79336-01 |
|
 前へ |
このコマンドおよびAPIリファレンスは、Oracle Event Processingに適用するOracle SpatialコマンドおよびAPIの構文と例を説明しています。
ANYINTERACT Oracle Spatialジオメトリ比較演算子は、キーがジオメトリ(geom)に接触する場合にtrueを返し、そうでない場合にfalseを返します。
構文
ANYINTERACT@spatial(geom, key, tol)
geom: サポートされているジオメトリ・タイプ
key: GTYPE_POINT、GTYPE_CURVE、GTYPE_POLYGON、GTYPE_SURFACE、GTYPE_COLLECTION、GTYPE_MULTIPOINT、GTYPE_MULTICURVE、GTYPE_MULTIPOLYGON、GTYPE_SOLIDまたはGTYPE_MULTISOLIDジオメトリ・タイプ
このジオメトリのジオメトリ・タイプはGTYPE_POINTである必要があり、それ以外の場合はRUNTIME_EXCEPTIONが発生します。
tol: double値としての許容差。許容差の値は、境界の厚さを拡大します。
例
<view id="op_in_where"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where ANYINTERACT@spatial(shop.geom, loc.curLoc, 5.0d) = true ) </view> <view id="op_in_proj"> RStream( select loc.customerId, shop.shopId, ANYINTERACT@spatial(shop.geom, loc.curLoc, 5.0d) from LocGeomStream[NOW] as loc, ShopGeomRelation as shop ) </view>
com.oracle.cep.cartridge.spatial.Geometryのbufferメソッドは、入力ジオメトリのバッファ・バージョンであるoracle.spatial.geometry.JGeometryの新規オブジェクトを返します。
構文
bufferWidth: このバッファに使用する距離値(double値)
この値は、予定ジオメトリの予測単位と同じ単位であると見なされます。ジオメトリが測地の場合、このバッファの幅はメーターになります。
SMA: 長半径(double値)
ジオメトリが測地の場合に、このパラメータを設定します。
iFlat: CSパラメータからの扁平度(double値)
ジオメトリが測地の場合に、このパラメータを設定します。
arcT: 測地円弧を高密度化するarc_tolerance(double値)
com.oracle.cep.cartridge,spatial.geometry.buffer(bufferWidth, SMA, iFlat, actT)
例
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.buffer(13, 2, 4, 7) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのbufferPolygonメソッドは、oracle.spatial.geometry.JGeometryポリゴン入力のバッファ・バージョンであるcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。このメソッドは、入力機能周辺の指定距離でバッファ・ポリゴンを作成します。
構文
com.oracle.cep.cartridge.spatial.Geometry.bufferPolygon(polygon, distance)
polygon: oracle.spatial.geometry.JGeometryポリゴン
distance: 入力機能周の距離を指定するdouble値
distance値は、射影されたジオメトリの射影ユニットと同じユニットにあると想定します。ジオメトリが測地の場合、distanceはメートル単位である必要があります。
例
このメソッドは、Oracle Spatialのアプリケーション・コンテキストからパラメータを取得します。spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialアプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.bufferPolygon@spatial(geom, 1300)
次の例では、バッファ・ポリゴンを作成します。この例はOracle Spatialアプリケーション・コンテキストに基づくため、spatialリンク名を使用します。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.bufferPolygon@spatial(geom, 13) from CustomerLocStream </view>
Oracle Spatialジオメトリ比較演算子CONTAINは、ジオメトリが他のジオメトリに含まれる場合はtrueを返し、そうでない場合はfalseを返します。
構文
CONTAIN@spatial(geom, key)
geom: サポートされているジオメトリ・タイプ
key: GTYPE_POINT、GTYPE_CURVE、GTYPE_POLYGON、GTYPE_SURFACE、GTYPE_COLLECTION、GTYPE_MULTIPOINT、GTYPE_MULTICURVE、GTYPE_MULTIPOLYGON、GTYPE_SOLIDまたはGTYPE_MULTISOLIDジオメトリ・タイプ
例
<view id="op_in_where"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where CONTAIN@spatial(shop.geom, loc.curLoc, 5.0d) = true ) </view> <view id="op_in_proj"> RStream( select loc.customerId, shop.shopId, CONTAIN@spatial(shop.geom, loc.curLoc, 5.0d) from LocGeomStream[NOW] as loc, ShopGeomRelation as shop ) </view>
com.oracle.cep.cartridge.spatial.GeometryのconvertTo2Dメソッドは、oracle.spatial.geometry.JGeometry 3Dオブジェクトをoracle.spatial.geometry.JGeometry 2Dオブジェクトに変換します。
構文
com.oracle.cep.cartridge.spatial.Geometry.convertTo2D(geom)
geomパラメータはoracle.spatial.geometry.JGeometry 3Dオブジェクトです。
例
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.convertTo2D(geom) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのconvertTo3Dメソッドはoracle.spatial.geometry.JGeometry 2Dオブジェクトをoracle.spatial.geometry.JGeometry 3Dオブジェクトに変換します。この変換でz座標はゼロ詰めされます。
構文
com.oracle.cep.cartridge.spatial.Geometry.convertTo3D(geom)
geomパラメータはoracle.spatial.geometry.JGeometry 2Dオブジェクトです。
例
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.convertTo3D(geom) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのcreateCircleメソッドは、2Dまたは3Dの円であるcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。
2D円構文の作成
com.oracle.cep.cartridge.spatial.Geometry.createCircle(x, y, radius) com.oracle.cep.cartridge.spatial.Geometry.createCircle(x, y, radius, srid)
x: 円の中心のx座標(double値)
y: 円の中心のy座標(double値)
radius: 測地円弧を高密度化するarc_tolerance(double値)
srid: 円のオプションのSDO_SRID (int値)。sridパラメータを省略する場合は、例が示すようにspatialリンク名を追加します。
3D円構文の作成
com.oracle.cep.cartridge.spatial.Geometry.createCircle(x1, y1, x2, y2, x3, y3)
com.oracle.cep.cartridge.spatial.Geometry.createCircle(srid, x1, y1, x2, y2, x3,
y3)
円周を構成する3座標を次の引数で指定します。
x1: 点1のx縦座標(double値)
y1: 点1のy縦座標(double値)
x2: 点2のx縦座標(double値)
y2: 点2のy縦座標(double値)
x3: 点3のx縦座標(double値)
y3: 点3のy縦座標(double値)
srid: 円のオプションのSRID (int値)。sridパラメータを省略した場合は、例が示すようにspatialリンク名(@spatial)を追加します。
例
オプションのsridパラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジ・アプリケーション・コンテキストからパラメータを取得します。この場合、spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialデータ・カートリッジ・アプリケーション・コンテキストに関連付けます。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createCircle@spatial(x, y)
次の例では、sridパラメータを使用して2Dの円を作成します。この例ではsridパラメータを使用するため、spatialリンク名は必要ありません。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createCircle(x, y, 300, srid) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのcreateElemInfoメソッドは、指定された引数から、単一の要素情報値をint[]値で返します。「einfogenerator」も参照してください。
構文
com.oracle.cep.cartridge.spatial.Geometry.createElemInfo(offset, etype, interp)
soffset: この要素の最初の縦座標が保存される縦座標配列内にあるint値のオフセット
SDO_STARTING_OFFSET値は0からではなく1から開始します。このため最初の要素の第1の縦座標はSDO_GEOMETRY.Ordinates(1)になります。2つ目の要素がある場合、その要素の第1の縦座標はSDO_GEOMETRY.Ordinates(n * 3 + 2)になり、nはSDO_ORDINATE_ARRAY定義内の位置を示します。
etype: 要素のタイプ(int値)。
Oracle SpatialではSDO_ETYPE値の1、1003および2003をサポートしており、これらは(複合型ではなく)単純な要素と見なされます。これらは、要素情報配列の3つのエントリ1組によって定義されます。タイプは次のとおりです。
1: 点。
1003: ポリゴンの外部の輪(反時計回りで指定される必要があります)。
2003: ポリゴンの内部の輪(時計回りで指定される必要があります)。
これらのタイプは、SDO_INTERPRETATIONによって詳細に修飾されます。
注意:
1桁と4桁のSDO_ETYPE値を同じのジオメトリに混在させないでください。
interp: 解釈(int値)
単純要素SDO_ETYPE(1、1003または2003)の場合、SDO_INTERPRETATION属性によってこの要素に対する座標の順序の解釈方法が決定されます。たとえば、ポリゴン境界は、連結された一連の直線セグメントで構成されます。
ジオメトリが複数の要素で構成される場合、ある要素の最後の縦座標は、常に次の要素の先頭のオフセットより1小さくなります。ジオメトリの最後の要素は、その開始オフセットから縦座標可変長配列の最後までの縦座標によって記述されます。
表A-1は、SDO_ETYPEとSDO_INTERPREATIONの関係を示しています。
|
表A-1 SDO_ETYPEおよびSDO_INTERPRETATION
|
例
<view id="ShopGeom"> select com.oracle.cep.cartridge.spatial.Geometry.createGeometry@spatial( com.oracle.cep.cartridge.spatial.Geometry.GTYPE_POLYGON, com.oracle.cep.cartridge.spatial.Geometry.createElemInfo(1, 1003, 1), ordsgenerator@spatial( lng1, lat1, lng2, lat2, lng3, lat3, lng4, lat4, lng5, lat5, lng6, lat6 ) ) as geom from ShopDesc </view>
com.oracle.cep.cartridge.spatial.GeometryのcreateGeometryメソッドは2Dのoracle.cep.cartridge.spatial.Geometry新規オブジェクトを返します。
構文
com.oracle.cep.cartridge.spatial.Geometry(gtype, elemInfo, ordinates) com.oracle.cep.cartridge.spatial.Geometry(gtype, srid, elemInfo, ordinates)
gtype: ジオメトリ・タイプ(int値)
詳細は、表A-2を参照してください。
eleminfo: ジオメトリ要素情報(int[]値)
詳細は、「createElemInfo」を参照してください。
ordinates: ジオメトリ縦座標(double[]値)
srid: ジオメトリのオプションのSDO_SRID (int値)。sridパラメータを省略した場合は、例が示すようにspatialリンク名(@spatial)を追加します。
例
sridパラメータを省略すると、このメソッドはOracle Spatialのアプリケーション・コンテキストからパラメータを取得します。この場合、spatialリンク名を使用してメソッド呼出しをOracle Spatialアプリケーション・コンテキストに関連付ける必要があります。詳細は、「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createGeometry@spatial(gtype, eleminfo,
ordinates)
次の例では、sridパラメータを使用してジオメトリを作成します。この例ではsrid引数を使用するため、@spatialリンク名は必要ありません。
<view id="ShopGeom">
select com.oracle.cep.cartridge.spatial.Geometry.createGeometry(
com.oracle.cep.cartridge.spatial.Geometry.GTYPE_POLYGON,
srid,
com.oracle.cep.cartridge.spatial.Geometry.createElemInfo(1, 1003, 1,
srid),
ordsgenerator@spatial(
lng1, lat1, lng2, lat2, lng3, lat3,
lng4, lat4, lng5, lat5, lng6, lat6
)
) as geom
from ShopDesc
</view>
com.oracle.cep.cartridge.spatial.GeometryのcreateLinearLineStringメソッドは、要素情報が{1, 2, 1}の直線ストリングである、3Dのcom.oracle.cep.cartridge.spatial.Geometry新規ジオメトリを返します。指定された座標のディメンションが2の場合、z座標はゼロ詰めされます。
構文
com.oracle.cep.cartridge.spatial.Geometry.createLinearLineString(coords, dim)
com.oracle.cep.cartridge.spatial.Geometry.createLinearLineString(srid, coords,
dim)
coords: 直線ストリングの座標(double[]値)
dim: 指定された座標のディメンション(int値)。
srid: ジオメトリのオプションのSDO_SRID (int値)。sridパラメータを省略する場合は、例が示すようにspatialリンク名を追加します。
詳細は、「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
例
sridパラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialデータ・カートリッジ・アプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createLinearLineString@spatial(coords,
dim)
次の例では、sridパラメータを使用して直線ストリングを作成します。この例ではsridパラメータを使用するため、@spatialリンク名は使用しません。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createLinearLineString(coords, dim, srid) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのcreateMultiLineStringメソッドは、直線マルチライン・ストリングである、3Dのcom.oracle.cep.cartridge.spatial.Geometry新規ジオメトリを返します。指定された座標のディメンションが2の場合、z座標はゼロ詰めされます。
構文
com.oracle.oep.cartridge.spatial.Geometry.createMultiLineString(coords, dim) com.oracle.cep.cartridge.spatial.Geometry.createMultiLineString(srid, coords, dim)
coords: 直線ストリングの座標(double[][]値)
dim: 指定された座標のディメンション(int値)
srid: intとしてのジオメトリのオプションのSRID。sridパラメータを省略した場合は、例が示すようにspatialリンク名(@spatial)を追加します。
例
sridパラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialデータ・カートリッジ・アプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createLinearMultiLineString@spatial(
coords, dim)
次の例では、直線マルチライン・ストリングを作成します。この例ではsrid引数を使用するため、spatialリンク名は使用しません。
<view id="LocGeomStream" schema="customerId curLoc">
select
customerId,
com.oracle.cep.cartridge.spatial.Geometry.createLinearMultiLineString(coords, dim,
srid)
from
CustomerLocStream
</view>
com.oracle.cep.cartridge.spatial.GeometryのcreateLinearPolygonメソッドは、穴のない2Dの単純線ポリゴンであるcom.oracle.cep.cartridge.spatial.Geometry新規オブジェクトを返します。座標配列が閉じられていない(最後の座標が最初の座標と同じでない)場合、このメソッドは最初の座標をコピーしてその座標値を入力座標配列の最後に追加します。
構文
com.oracle.cep.cartridge.spatial.Geometry.createLinearPolygon(coords{])
com.oracle.cep.cartridge.spatial.Geometry.createLinearPolygon(srid, coords[])
coords: double[]としての線形ポリゴンの座標。
srid: intとしてのジオメトリのオプションのSRID。sridパラメータを省略した場合は、例が示すようにspatialリンク名(@spatial)を追加します。
例
オプションのsridパラメータを省略すると、このメソッドはOracle Spatialアプリケーション・コンテキストからパラメータを取得します。この場合、spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialアプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createLinearPolygon@spatial(coords)
次の例では、sridパラメータを使用して線形ポリゴンを作成します。この例ではsrid引数を使用するため、spatialリンク名は使用しません。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createLinearPolygon(coords, srid) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのcreateMultiPointメソッドは、マルチポイント・ジオメトリであるcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。
構文
com.oracle.cep.cartridge.spatial.Geometry.createMultiPoint(coords[][], dim) com.oracle.cep.cartridge.spatial.Geometry.createMultiPoint(srid, coords[][], dim)
coords: それぞれが1点を持つdouble型を格納した配列の配列
dim: 各点のディメンション(int値)
srid: intとしてのジオメトリのオプションのSRID。sridパラメータを省略した場合は、例が示すようにspatialリンク名(@spatial)を追加します。
例
sridパラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。この場合、spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialデータ・カートリッジ・アプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createMultiPoint@spatial(coords, dim)
次の例では、sridパラメータを使用してマルチポイント・ジオメトリを作成します。この例ではsridパラメータを使用するため、spatialリンク名は使用しません。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createMultiPoint(coords, dim, srid) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのcreatePointメソッドは、3Dの点であるcom.oracle.cep.cartridge.spatial.Geometry新規オブジェクトを返します。
構文
com.oracle.cep.cartridge.spatial.Geometry.createPoint(x, y) com.oracle.cep.cartridge.spatial.Geometry.createPoint(srid, x, y)
x: doubleとしての左下のx座標。
y: doubleとしての左下のy座標。
srid: intとしてのジオメトリのオプションのSRID。sridパラメータを省略した場合は、例が示すようにspatialリンク名(@spatial)を追加します。
sridパラメータを省略すると、このメソッドはOracle Spatialのアプリケーション・コンテキストからパラメータを取得します。この場合、spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialアプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください
com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(x, y)
次の例では、sridパラメータを使用して点を作成します。この例ではsridパラメータを使用するため、spatialリンク名は使用しません。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createPoint(lng, lat, srid) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.GeometryのcreateRectangleメソッドは、2D矩形である新規のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。
構文
com.oracle.cep.cartridge.spatial.Geometry.createRectangle(x1, y1, x2, y2) com.oracle.cep.cartridge.spatial.Geometry.createRectangle(srid, x1, y1, x2, y2)
x1: doubleとしての左下のx座標。
y1: doubleとしての左下のy座標。
x2: doubleとしての右上のx座標。
y2: doubleとしての右上のy座標。
srid: intとしてのジオメトリのオプションのSRID。
例
sridパラメータを省略すると、このメソッドはOracle Spatialのアプリケーション・コンテキストからパラメータを取得します。この場合、spatialリンク名(@spatial)を使用してメソッド呼出しをOracle Spatialアプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.createRectangle@spatial(x1, y1, x2, y2)
次の例では、矩形を作成します。この例ではsridパラメータを使用するため、spatialリンク名は必要ありません。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createRectangle(x1, y1, x2, y2, srid) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.Geometryのdistanceメソッドは、2つのジオメトリ間の距離(double値)を計算します。
構文
com.oracle.cep.cartridge.spatial.Geometry.distance(g1, g2) com.oracle.cep.cartridge.spatial.Geometry.distance(geoParam, g1, g2)
異なるcom.oracle.cep.cartridge.spatial.Geometryオブジェクト間の距離を計算するには、現在のGeometryオブジェクトの静的でないdistanceメソッドを、次の引数を指定して使用します。
g: 他のcom.oracle.cep.cartridge.spatial.Geometryオブジェクト。
2つのcom.oracle.cep.cartridge.spatial.Geometryオブジェクト間の距離を計算するには、次の引数を指定して静的なdistanceメソッドを使用します。
g1: 1つ目のcom.oracle.cep.cartridge.spatial.Geometryオブジェクト。
g2: 2つ目のcom.oracle.cep.cartridge.spatial.Geometryオブジェクト。
例
このメソッドは、Oracle Spatialのアプリケーション・コンテキストからパラメータを取得します。spatialリンク名を使用してメソッド呼出しをOracle Spatialアプリケーション・コンテキストに関連付ける必要があります。「Oracle Spatialアプリケーション・コンテキスト」を参照してください。
com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom) com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom1, geom2)
次の例では、2つのジオメトリ間の距離を計算します。distanceメソッドはOracle Spatialのアプリケーション・コンテキストに依存するため、spatialリンク名を使用する必要があります。
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createRectangle(x1, y1, x2, y2, srid) from CustomerLocStream where com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom1, geom2) < 5 </view>
Oracle CQL関数einfogeneratorは、指定された引数から、単一のinfo要素をint[]値で返します。com.oracle.cep.cartridge.spatial.Geometry.createElemInfoメソッドを使用する場合は、「createElemInfo」も参照してください。
構文
einfogenerator@spatial(offset, etype, interp)
offset: この要素の第1の縦座標が格納されている縦座標配列内の、intとしてのオフセット。
SDO_STARTING_OFFSET値は0からではなく1から開始します。このため最初の要素の第1の縦座標はSDO_GEOMETRY.Ordinates(1)になります。2つ目の要素がある場合、その要素の第1の縦座標はSDO_GEOMETRY.Ordinates(n * 3 + 2)になり、nはSDO_ORDINATE_ARRAY定義内の位置を示します。
etype: intとしての要素のタイプ。
Oracle SpatialではSDO_ETYPE値の1、1003および2003をサポートしており、これらは(複合型ではなく)単純な要素と見なされます。これらは、要素情報配列の3つのエントリ1組によって定義されます。タイプは次のとおりです。
1: 点
1003: ポリゴンの外部の輪(反時計回りで指定される必要があります)。
2003: ポリゴンの内部の輪(時計回りで指定される必要があります)。
これらのタイプは、SDO_INTERPRETATIONによって詳細に修飾されます。
注意:
1桁と4桁のSDO_ETYPE値を単一のジオメトリに混在させることはできません。
interp: intとしての解釈。
SDO_ETYPEが単純な要素(1、1003または2003)である場合、SDO_INTERPRETATION属性によって、この要素の座標の順序の解釈方法が決定されます。たとえば、ポリゴン境界は、連結された一連の直線セグメントで構成されます。
ジオメトリが複数の要素で構成される場合、ある要素の最後の縦座標は、常に次の要素の先頭のオフセットより1小さくなります。ジオメトリの最後の要素は、その開始オフセットから縦座標可変長配列の最後までの縦座標によって記述されます。
表A-2は、SDO_ETYPEとSDO_INTERPREATIONの関係を示しています。
|
表A-2 SDO_ETYPEおよびSDO_INTERPRETATION
|
例
Oracle CQL関数のため、パッケージ接頭辞を使用せず、spatialリンク名を使用して呼出します。次の例では、ジオメトリの要素情報を作成します。
view id="ShopGeom"> select com.oracle.cep.cartridge.spatial.Geometry.createGeometry@spatial( com.oracle.cep.cartridge.spatial.Geometry.GTYPE_POLYGON, einfogenerator@spatial(1, 1003, 1), ordsgenerator@spatial( lng1, lat1, lng2, lat2, lng3, lat3, lng4, lat4, lng5, lat5, lng6, lat6 ) ) as geom from ShopDesc </view>
Oracle Spatialジオメトリ・フィルタ演算子FILTERは、非接続でないオブジェクト・ペアの場合はtrueを返し、そうでない場合はfalseを返します。
FILTER@spatial(key, tol)
key: GTYPE_POINT、GTYPE_CURVE、GTYPE_POLYGON、GTYPE_SURFACE、GTYPE_COLLECTION、GTYPE_MULTIPOINT、GTYPE_MULTICURVE、GTYPE_MULTIPOLYGON、GTYPE_SOLIDまたはGTYPE_MULTISOLIDジオメトリ・タイプ
tol: double値としての許容範囲。
例
Oracle Spatialジオメトリ・フィルタ演算子のため、パッケージ接頭辞を使用せず、spatialリンク名を使用して呼出します。次の例では、非接続でないオブジェクト・ペアを判定します。
<view id="filter"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where FILTER@spatial(loc.curLoc, 5.0d) = true ) </view>
com.oracle.cep.cartridge.spatial.Geometryのget2dMbrメソッドは、指定されたGeometryの最小境界矩形(MBR)をdouble[][]値で返します。
構文
com.oracle.cep.cartridge.spatial.Geometry.get2DMbr(geom)
geomパラメータは、このメソッドが境界矩形を返す対象のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトです。返された境界矩形には次の値が含まれます。
[0][0]: minX
[0][1]: maxX
[1][0]: minY
[1][1]: maxY
例
次の例では、geomの境界矩形を返します。
<view id="LocGeomStream" schema="customerId mbr"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.get2dMbr(geom) from CustomerLocStream where com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom1, geom2) < 5 </view>
Oracle Spatial比較演算子INSIDEはGTYPE_POINTがジオメトリの内側の場合はtrueを返し、そうでない場合はfalseを返します。
構文
INSIDE@spatial(geom, key)
geom: サポートされるすべてのジオメトリ・タイプ。
key: GTYPE_POINT、GTYPE_CURVE、GTYPE_POLYGON、GTYPE_SURFACE、GTYPE_COLLECTION、GTYPE_MULTIPOINT、GTYPE_MULTICURVE、GTYPE_MULTIPOLYGON、GTYPE_SOLIDまたはGTYPE_MULTISOLIDジオメトリ・タイプ
例
次のOracle CQL問合せは、点がジオメトリの内側にあるかを判定します。
<view id="op_in_where"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where INSIDE@spatial(shop.geom, loc.curLoc, 5.0d) = true ) </view> <view id="op_in_proj"> RStream( select loc.customerId, shop.shopId, INSIDE@spatial(shop.geom, loc.curLoc, 5.0d) from LocGeomStream[NOW] as loc, ShopGeomRelation as shop ) </view>
Oracle Spatialジオメトリ比較演算子INSIDE3Dは、3Dジオメトリgeom1が3D空間geom2の内側にある場合はtrueを返し、そうでない場合はfalseを返します。
構文
INSIDE3D@spatial(geom1, geom2) INSIDE3D@spatial(geom1, geom2)
geom1: 含有されるジオメトリで、サポートされている3Dジオメトリ
geom2: 含有するジオメトリで、サポートされている3Dジオメトリ
例
次のOracle CQL問合せは、点が3Dジオメトリの内側にあるかを判定します。
<view id="op_in_where"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where INSIDE3D@spatial(shop.geom1, shop.geom2) = true ) </view> <view id="op_in_proj"> RStream( select loc.customerId, shop.shopId, INSIDE@spatial(shop.geom1, shop.geom2) from LocGeomStream[NOW] as loc, ShopGeomRelation as shop ) </view>
Oracle Spatialジオメトリ・フィルタ演算子NNは、geomから、キーに最も近いオブジェクト(最近傍)を返します。2つのジオメトリ・オブジェクトの近さを判定するため、Oracle Event Processingは使用される各オブジェクトの面の任意の2点間の最短距離が使用されます。
構文
NN@spatial(geom, key, tol)
geom: サポートされるすべてのジオメトリ・タイプ。
key: GTYPE_POINT、GTYPE_CURVE、GTYPE_POLYGON、GTYPE_SURFACE、GTYPE_COLLECTION、GTYPE_MULTIPOINT、GTYPE_MULTICURVE、GTYPE_MULTIPOLYGON、GTYPE_SOLIDまたはGTYPE_MULTISOLIDジオメトリ・タイプ
tol: double値としての許容範囲。
例
次のOracle CQL問合せは最近傍を判定します。
<view id="filter"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where NN@spatial(shop.geom, loc.curLoc, 5.0d) = true ) </view>
Oracle CQL関数ordsgeneratorは、座標パラメータ値から、2D座標のdouble配列を返します。
構文
ordsgenerator@spatial(x1, y1, ..., xN, yN)
パラメータ値はカンマ区切りの座標値のリストです。この関数は、入力から、2D座標のdouble配列を返します。
例
次の例では、6つのdouble座標値からOracle Spatial double配列を作成します。
view id="ShopGeom"> select com.oracle.cep.cartridge.spatial.Geometry.createGeometry@spatial( com.oracle.cep.cartridge.spatial.Geometry.GTYPE_POLYGON, com.oracle.cep.cartridge.spatial.Geometry.createElemInfo(1, 1003, 1), ordsgenerator@spatial( lng1, lat1, lng2, lat2, lng3, lat3, lng4, lat4, lng5, lat5, lng6, lat6 ) ) as geom from ShopDesc </view>
com.oracle.cep.cartridge.spatial.Geometryのto_Geometryメソッドは、oracle.spatial.geometry.JGeometry型を3D com.oracle.cep.cartridge.spatial.Geometry型に変換します。
構文
com.oracle.cep.cartridge.spatial.Geometry.to_Geometry(geom)
geomパラメータは、変換するoracle.spatial.geometry.JGeometryオブジェクトです。指定されたジオメトリがすでにGeometryタイプおよび3Dジオメトリである場合、変換は行われません。指定されたジオメトリが2Dのジオメトリの場合、z座標を埋め込むことでジオメトリは3Dに変換されます。
例
次の例では、2Dジオメトリgeoを3Dジオメトリに変換します。
<view id="LocStream" schema="customerId loc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.to_Geometry(geom) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.Geometryのto_J3D_Geometryメソッドは、com.oracle.cep.cartridge.spatial.Geometryオブジェクトをoracle.spatial.geometry.J3D_Geometryオブジェクトに変換します。
構文
com.oracle.cep.cartridge.spatial.Geometry.to_J3D_Geometry(g)
gパラメータは、変換するcom.oracle.cep.cartridge.spatial.Geometryオブジェクトです。
例
次の例は、to_J3D_Geometryメソッドの使用方法を示しています。
<view id="LocStream" schema="customerId loc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.to_J3D_Geometry(geom) from CustomerLocStream </view>
com.oracle.cep.cartridge.spatial.Geometry.to_JGeometryメソッドはcom.oracle.cep.cartridge.spatial.Geometryオブジェクトをoracle.spatial.geometry.JGeometry 2D型に変換します。
構文
com.oracle.cep.cartridge.spatial.Geometry.to_JGeometry(g)
gパラメータは、変換するcom.oracle.cep.cartridge.spatial.Geometryオブジェクトです。
例
次の例では、2Dジオメトリ・オブジェクトgeomを2D JGeometryオブジェクトに変換します。
<view id="LocStream" schema="customerId loc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.to_JGeometry(geom) from CustomerLocStream </view>
Oracle CQL問合せWITHINDISTANCEは、GTYPE_POINTがジオメトリの指定距離内にある場合はtrueを返し、そうでない場合はfalseを返します。
構文
WITHINDISTANCE@spatial(geom, key, dist)
geom: サポートされるすべてのジオメトリ・タイプ。
key: GTYPE_POINT、GTYPE_CURVE、GTYPE_POLYGON、GTYPE_SURFACE、GTYPE_COLLECTION、GTYPE_MULTIPOINT、GTYPE_MULTICURVE、GTYPE_MULTIPOLYGON、GTYPE_SOLIDまたはGTYPE_MULTISOLIDジオメトリ・タイプ
dist: double値としての距離。
例
次のOracle CQL問合せは、loc.curLocがshop.geomの5.0dの距離内にあるかを判定します。
<view id="op_in_where"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where WITHINDISTANCE@spatial(shop.geom, loc.curLoc, 5.0d) = true ) </view> <view id="op_in_proj"> RStream( select loc.customerId, shop.shopId, WITHINDISTANCE@spatial(shop.geom, loc.curLoc, 5.0d) from LocGeomStream[NOW] as loc, ShopGeomRelation as shop ) </view>
