この章では、Oracle Spatialデータ・カートリッジが公開する型、メソッド、フィールドおよびコンストラクタについて説明します。これらの型、メソッド、フィールドおよびコンストラクタを、Oracle CQLのネイティブ型と同様に、Oracle CQLの問合せおよびビューで使用できます。
この章の内容は、次のとおりです。
詳細は、以下を参照してください。
Oracle Spatialは、高度な空間機能を提供するOracle Databaseのオプションで、ハイエンドな地理情報システム(GIS)および位置情報対応型のビジネス・インテリジェンス・ソリューション(LBS)をサポートします。
Oracle Spatialデータ・カートリッジは、Oracle CEPアプリケーションでOracle Spatialクラスとシームレスに対話するOracle CQLの問合せおよびビューを記述するための、オプションのデータ・カートリッジです。
Oracle Spatialデータ・カートリッジを使用すると、空間データの索引作成が可能になり、空間データの格納、空間データでの近接および重複比較の実行、空間データとOracle CQLサーバーの統合など、重要な地理ドメイン操作を実行するOracle CQL問合せを構成できます。
Oracle Spatialデータ・カートリッジを使用するには、Oracle Spatial APIに関する実用的な知識が必要です。Oracle Spatialの詳細は、次の資料を参照してください。
製品の概要: http://www.oracle.com/technology/products/spatial/index.html
Oracle Spatialのドキュメント: http://www.oracle.com/pls/db112/portal.portal_db?selected=7&frame=#oracle_spatial_and_location_information
Oracle Spatial Java APIリファレンス: http://download.oracle.com/docs/cd/E11882_01/appdev.112/e11829/toc.htm
この項の内容は、次のとおりです。
Oracle Spatialデータ・カートリッジでは、カートリッジID com.oracle.cep.cartrdiges.spatial
を使用してサーバー・スコープ予約済リンク名spatial
を登録します。
spatial
リンク名を使用して、Oracle Spatialデータ・カートリッジのメソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付けます。
詳細は、以下を参照してください。
Oracle Spatialデータ・カートリッジはOracle Spatial Java APIに基づいています。Oracle Spatialデータ・カートリッジはOracle Spatial機能をcom.oracle.cep.cartridge.spatial.Geometry
クラスに公開します。Oracle Spatial Java APIにないOracle Spatial機能に、Oracle Spatialデータ・カートリッジからアクセスすることはできません。
Oracle CQL問合せでは、Oracle Spatialデータ・カートリッジを使用して、表16-1に示すOracle Spatial機能にアクセスできます。
表16-1 Oracle Spatialデータ・カートリッジの有効範囲
Oracle Spatialの機能 | 有効範囲 |
---|---|
ジオメトリ・タイプ |
Oracle Spatial Java APIの次のジオメトリ・タイプ:
次のジオメトリ操作:
詳細は、以下を参照してください。 |
ジオメトリ関係演算子 |
詳細は、16.1.2.3項「ジオメトリ関係演算子」を参照してください。 |
ジオメトリ・フィルタ演算子 |
詳細は、16.1.2.4項「ジオメトリ・フィルタ演算子」を参照してください。 |
ジオメトリ索引 |
詳細は、16.1.2.5項「ジオメトリ索引」を参照してください。 |
座標系 |
詳細は、16.1.2.6項「縦座標および座標系とSDO_SRID」を参照してください。 |
com.oracle.cep.cartridge.spatial.Geometry
で提供されているメソッドの完全なリストは、16.1.2.7項「ジオメトリAPI」を参照してください。
Oracle Spatialデータ・カートリッジを使用してこれらのOracle Spatial機能にアクセスする方法の詳細は、16.2項「Oracle Spatialデータ・カートリッジの使用」を参照してください。
Oracle Spatialデータ・カートリッジのデータ・モデルはジオメトリで構成されます。ジオメトリは、順序の付いた一連の頂点です。ジオメトリのセマンティクスは、そのタイプによって決まります。
Oracle Spatialデータ・カートリッジを使用すると、Oracle CQLの問合せとビューで次のOracle Spatialタイプに直接アクセスできます。
SDO_GTYPES
: Oracle Spatialデータ・カートリッジは次のジオメトリ・タイプをサポートしています。
2Dの点
2Dの単純ポリゴン
2Dの矩形
表16-2は、使用可能なcom.oracle.cep.cartridge.spatial.Geometry
クラスのジオメトリ・タイプを示しています。
SDO_ELEMENT_INFO
: 次の項目を使用して、要素情報配列を作成できます。
com.oracle.cep.cartridge.spatial.Geometry.createElemInfo
静的メソッド
einfogenerator
関数
詳細は、16.1.2.2項「要素情報配列」を参照してください。
ORDINATES
: Oracle Spatialデータ・カートリッジordsgenerator
関数を使用して、縦座標を作成できます。
詳細は、16.1.2.6項「縦座標および座標系とSDO_SRID」を参照してください。
詳細は、以下を参照してください。
Element Info属性は、可変長の数値配列を使用して定義されます。この属性は、Ordinates属性に格納されている縦座標を解釈する方法を指定します。
Oracle Spatialデータ・カートリッジには、Element Info属性値を生成するために、次のヘルパー関数が用意されています。
com.oracle.cep.cartridge.spatial.Geometry.createElemInfo(int SDO_STARTING_OFFSET, int SDO_ETYPE , int SDO_INTERPRETATION)
einfogenerator
関数を使用することもできます。
詳細は、以下を参照してください。
『Oracle Spatial開発者ガイド』のSDO_ELEM_INFOに関する項
Oracle Spatialデータ・カートリッジは、Oracle CQL問合せのprojection句またはwhere句で、すべてのOracle Spatialジオメトリ関係演算子をサポートしています。
Oracle CQL問合せのwhere句でジオメトリ関係演算子を使用する場合、Oracle Spatialデータ・カートリッジで、where句で指定された関係に対してRツリー索引を作成できます。
Oracle Spatialデータ・カートリッジは、点と他のジオメトリ・タイプ間のジオメトリック関係のみをサポートします。ジオメトリのジオメトリ・タイプはGTYPE_POINT
である必要があり、そうでない場合はRUNTIME_EXCEPTION
がスローされます。
詳細は、16.2.4項「ジオメトリ関係演算子の使用方法」を参照してください。
FILTER
およびNN
演算子はプライマリ・フィルタリングを実行するため、Oracle CQL問合せのwhere句でのみ使用されます。これらのフィルタ演算子は空間索引を使用して、特定オブジェクトと空間で相互作用する一連の空間オブジェクトを識別します。
詳細は、以下を参照してください。
Oracle Spatialデータ・カートリッジでは空間索引を使用して、1次フィルタを実装します。空間索引の目的は、データのサブセットを迅速に作成し、2次フィルタでの処理の負荷を軽減することです。
空間索引は他の索引と同様、検索対象を限定するメカニズムを提供しますが、この場合は、メカニズムは交差や包含のような空間基準に基づきます。
Oracle Spatialデータ・カートリッジでは、デフォルトの索引作成メカニズムにRツリー索引を使用しています。空間Rツリー索引では、最大4次元の空間データの索引を作成できます。Rツリー索引では、ジオメトリを囲む最小の矩形(最小境界矩形(MBR))によって各ジオメトリを近似させます。
詳細は、以下を参照してください。
『Oracle Spatial開発者ガイド』の空間データの索引作成に関する項
表16-3は、Oracle Spatialデータ・カートリッジでデフォルトでサポートされる座標系、および各座標系を識別するSDO_SRID
値を示しています。
表16-3 Oracle Spatialデータ・カートリッジの座標系
座標系 | SDO_SRID | 説明 |
---|---|---|
デカルト |
0 |
デカルト座標は、指定した基点からの点の位置を、空間の直交する軸を関連付けて測定する座標です。 |
測地(WGS84) |
8307 |
測地座標(地理座標)は、角度を持つ座標(経度および緯度)で、球体の極点の座標と密接に関連しており、地球上の特定の測地データに関連付けて定義されます。 これは、Oracle Spatialデータ・カートリッジのデフォルトの座標系です。 |
SDO_SRID
値は、呼び出す各Oracle Spatialメソッドおよびコンストラクタの引数として指定できます。また、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストでSDO_SRID
を1度構成すると、SDO_SRID
を毎回引数として設定しなくてもcom.oracle.cep.cartridge.spatial.Geometry
メソッドを使用できます。アプリケーション・コンテキストを使用して、Oracle Spatialでサポートされる任意の座標系を指定することもできます。
注意: SDO_SRID 値を使用しないcom.oracle.cep.cartridge.spatial.Geometry メソッドを使用する場合、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストを使用する必要があります。たとえば、次のメソッド呼出しを行うとランタイム例外が発生します。
com.oracle.cep.cartridge.spatial.Geometry.createPoint(lng, lat) かわりに、 com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat)
com.oracle.cep.cartridge.spatial.Geometry.createPoint(8307, lng, lat) com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat) 詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。 |
縦座標は、ダブル配列を使用してジオメトリの座標の配列を定義します。Oracle Spatialデータ・カートリッジには、座標の配列を生成するためにordsgenerator
ヘルパー関数が用意されています。構文については、「ordsgenerator」を参照してください。
詳細は、以下を参照してください。
『Oracle Spatial開発者ガイド』のSDO_SRIDに関する項
『Oracle Spatial開発者ガイド』の座標系(空間参照システム)に関する項
Oracle Spatialデータ・カートリッジはOracle Spatial Java APIに基づいています。Oracle Spatialデータ・カートリッジはOracle Spatial機能をcom.oracle.cep.cartridge.spatial.Geometry
クラスに公開します。このGeometry
クラスにより、oracle.spatial.geometry.J3D_Geometry
も拡張されます。
Oracle Spatialデータ・カートリッジでサポートされるは2Dのジオメトリのみですが、効率の向上のために、Geometry
クラスでは一部のJ3D_Geometry
メソッドも使用されます。Geometry
クラスでは、J3D_Geometry
メソッドのためにZ座標に自動的にゼロが埋め込まれます。
Geometry
クラスからアクセスできない(またはOracle Spatialデータ・カートリッジがサポートする有効範囲およびジオメトリ・タイプに準拠していない)Oracle Spatial機能に、Oracle Spatialデータ・カートリッジからアクセスすることはできません。
この項の内容は、次のとおりです。
詳細は、以下を参照してください。
表16-4は、Geometry
クラスで提供されるパブリック・メソッドを示しています。
注意: Geometry クラスでは大文字と小文字が区別されるため、表示されている方を使用してください。 |
注意: SDO_SRID 値を使用しないcom.oracle.cep.cartridge.spatial.Geometry メソッドを使用する場合、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストを使用する必要があります。たとえば、次のメソッド呼出しを行うとランタイム例外が発生します。
com.oracle.cep.cartridge.spatial.Geometry.createPoint(lng, lat) かわりに、 com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat)
com.oracle.cep.cartridge.spatial.Geometry.createPoint(8307, lng, lat) com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat) 詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。 |
次のJGeometry
パブリック・メソッドを、Oracle Spatialデータ・カートリッジに適用できます。
double area(double tolerance)
: 2Dジオメトリの平面の表面積合計を返します。
double length(double tolerance)
: 2Dジオメトリの周辺の長さを返します。すべての辺の長さが加えられます。
double[] getMBR()
: このジオメトリのMBRを返します。2DのMBRのminX
、minY
、maxX
およびmaxY
値を含むダブル配列を返します。
詳細は、以下を参照してください。
Oracle Spatialカートリッジは、1つのデータ型com.oracle.cep.cartridge.spatial.Geometry
をサポートしています。
com.oracle.cep.cartridge.spatial.Geometry
で提供されているメソッドの完全なリストは、16.1.2.7項「ジオメトリAPI」を参照してください。
Oracle Spatialデータ・カートリッジのインスタンスにアプリケーション・コンテキストを定義し、このアプリケーション・コンテキストをランタイム時に伝播できます。これにより、特定のOracle Spatialアプリケーション・デフォルト(SDO_SRID
など)を特定のOracle Spatialデータ・カートリッジ・インスタンスに関連付けることができます。
例16-1は、測地参照システム1980(GRS80)座標系を使用して、SpatialGRS80
という空間コンテキストをEPNアセンブリ・ファイルに作成する方法を示しています。
例16-1 EPNアセンブリ・ファイルのspatial:context要素
<spatial:context id="SpatialGRS80" srid="4269" sma="6378137" rof="298.25722101" />
例16-2は、Oracle CQL問合せでspatial:context
を参照する方法を示しています。この例では、問合せは(例16-1で定義された)リンク名SpatialGRS80
を使用して、このアプリケーション・コンテキストをOracle Spatialデータ・カートリッジに伝播しています。SpatialGRS80
のspatial:context
属性設定は、createPoint
メソッド呼出しに適用されます。
例16-2 Oracle CQL問合せでのspatial:contextの参照
<view id="createPoint"> select com.oracle.cep.cartridge.spatial.Geometry.createPoint@SpatialGRS80( lng, lat) from CustomerPos[NOW] </view>
詳細は(すべてのspatial:context
属性の完全なリストなど)、Eclipse用Oracle CEP開発者ガイドのOracle Spatialデータ・カートリッジのアプリケーション・コンテキストの構成に関する項を参照してください。
注意: SDO_SRID 値を使用しないcom.oracle.cep.cartridge.spatial.Geometry メソッドを使用する場合、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストを使用する必要があります。たとえば、次のメソッド呼出しを行うとランタイム例外が発生します。
com.oracle.cep.cartridge.spatial.Geometry.createPoint(lng, lat) かわりに、 com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat)
com.oracle.cep.cartridge.spatial.Geometry.createPoint(8307, lng, lat) com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat) 詳細は、16.1.2.7項「ジオメトリAPI」を参照してください。 |
この項では、Oracle CEPアプリケーションでOracle Spatialデータ・カートリッジをどのように使用できるかを中心に、一般的な使用例を説明します。内容は次のとおりです。
詳細は、16.1.2.7項「ジオメトリAPI」を参照してください。
次の手順では、Oracle CQL問合せでOracle Spatialデータ・カートリッジを使用してOracle Spatialジオメトリ・タイプSDO_GTYPE
、SDO_ELEMENT_INFO
およびORDINATES
にアクセスする方法について説明します。
Oracle Spatial Java APIでサポートされているジオメトリ・タイプにアクセスするには:
GTYPE_POLYGON
などのSDO_GTYPE
を選択します。
詳細は、16.1.2.1項「ジオメトリ・タイプ」を参照してください。
縦座標に適した要素情報を選択します。
詳細は、16.1.2.2項「要素情報配列」を参照してください。
座標の値を指定します。
詳細は、16.1.2.6項「縦座標および座標系とSDO_SRID」を参照してください。
例16-3に示すように、Oracle CQL問合せを作成します。
例16-3 Oracle Spatialジオメトリ・タイプを使用したOracle CQL問合せ
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>
次のメソッドを呼び出すことで、Oracle Spatialデータ・カートリッジを使用してOracle CQL問合せでジオメトリを作成できます。
com.oracle.cartridge.spatial.Geometry
の静的メソッド
Oracle Spatialデータ・カートリッジがサポートする有効範囲およびジオメトリ・タイプに準拠している、oracle.spatial.geometry.JGeometry
のメソッド。
詳細は、16.1.2.7項「ジオメトリAPI」を参照してください。
Oracle Spatialデータ・カートリッジ・ジオメトリ・クラスでの静的メソッドの使用
例16-4は、com.oracle.cartridge.spatial.Geometry
の静的メソッドを使用して点ジオメトリを作成する方法を示しています。この例では、リンク(@spatial
)を使用して、このクラスを提供するデータ・カートリッジを識別する必要があります。この方法の利点は、デフォルトで、または構成したアプリケーション・コンテキストに基づいて、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストが適用され、SRIDおよび他のOracle Spatialオプションが設定される点です(16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照)。
例16-4 ジオメトリ静的メソッドを使用した点ジオメトリの作成
<view id="CustomerPosGeom"> select com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial( lng, lat) as geom from CustomerPos[NOW] </view>
詳細は、16.1.2.1項「ジオメトリ・タイプ」を参照してください。
Oracle Spatialデータ・カートリッジを使用すると、Oracle CQLでOracle Spatialクラスのpublicメンバー関数およびpublicメンバー・フィールドに直接アクセスできます。
Geometry
クラスからアクセスできない(またはOracle Spatialデータ・カートリッジがサポートする有効範囲およびジオメトリ・タイプに準拠していない)Oracle Spatial機能に、Oracle Spatialデータ・カートリッジからアクセスすることはできません。
例16-5では、ビューShopGeom
はgeom
というOracle Spatialジオメトリを作成しています。ビューshopMBR
はJGeometry
静的メソッドgetMBR
を呼び出し、double[]
がストリーム要素mbr
として返されています。問合せqshopMBR
は標準Java APIを使用してこのdouble[]
にアクセスしています。
例16-5 ジオメトリ・タイプのpublicメソッドおよびフィールドへのアクセス
<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> <view id=”shopMBR”> select geom.getMBR() as mbr from ShopGeom </view> <query id=”qshopMBR”> select mbr[0], mbr[1], mbr[2], mbr[3] from shopMBR </query>
詳細は、以下を参照してください。
Oracle Spatialデータ・カートリッジを使用すると、Oracle CQL問合せのWHERE
句またはSELECT
句で、次のOracle Spatialジオメトリ関係演算子にアクセスできます。
ANYINTERACT
CONTAIN
INSIDE
WITHINDISTANCE
例16-6では、ビューop_in_where
はWHERE
句でCONTAIN
ジオメトリ関係演算子を使用しています。この例では、Oracle Spatialデータ・カートリッジはRツリー索引を使用しています。ビューop_in_proj
はSELECT
句でCONTAIN
を使用しています。
例16-6 ジオメトリ関係演算子の使用
<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>
詳細は、16.1.2.3項「ジオメトリ関係演算子」を参照してください。
Oracle Spatialデータ・カートリッジを使用すると、Oracle CQL問合せのWHERE
句で、次のOracle Spatialジオメトリ・フィルタ演算子にアクセスできます。
FILTER
NN
例16-7では、ビューfilter
はWHERE
でFILTER
ジオメトリ・フィルタ演算子を使用しています。
例16-7 ジオメトリ・フィルタ演算子の使用
<view id="filter"> RStream( select loc.customerId, shop.shopId from LocGeomStream[NOW] as loc, ShopGeomRelation as shop where FILTER@spatial(shop.geom, loc.curLoc, 5.0d) = true ) </view>
詳細は、16.1.2.4項「ジオメトリ・フィルタ演算子」を参照してください。
Oracle Spatialデータ・カートリッジのデフォルトのアプリケーション・コンテキストを使用してOracle CQL問合せを作成すると、デフォルトのSRID
がCARTESIAN
に設定されます。
例16-8に示すように、createPoint
メソッド呼出しはデフォルトのリンク(@spatial
)を使用します。これにより、Oracle Spatialデータ・カートリッジのデフォルトのアプリケーション・コンテキストが適用されるようになります。
例16-8 Oracle CQL問合せでのデフォルトの測地座標の使用
<view id="createPoint"> select com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial( lng, lat) from CustomerPos[NOW] </view>
詳細は、以下を参照してください。
次の手順では、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストを使用して、デフォルトのデカルト測地座標系以外の測地座標系をOracle CQL問合せで指定する方法について説明します。
詳細は、以下を参照してください。
他の測地座標を使用するには:
Oracle Spatialのアプリケーション・コンテキストを作成し、使用する測地座標のsrid
属性を定義します。
例16-9は、測地参照システム1980(GRS80)座標系を使用して、SpatialGRS80
という空間コンテキストをEPNアセンブリ・ファイルに作成する方法を示しています。
Oracle CQL問合せにおいて、リンクでこのspatial:contextのIDを使用します。
例16-10は、Oracle CQL問合せでspatial:context
を参照する方法を示しています。この例では、問合せは(例16-9で定義された)リンク名SpatialGRS80
を使用して、このアプリケーション・コンテキストをOracle Spatialデータ・カートリッジに伝播しています。SpatialGRS80
のspatial:context
属性設定は、createPoint
メソッド呼出しに適用されます。
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、入力oracle.spatial.geometry.JGeometry
ポリゴンのバッファされたバージョンである、新規のcom.oracle.cep.cartridge.spatial.Geometry
オブジェクトを返します。
このメソッドは次の引数を使用します。
polygon
: oracle.spatial.geometry.JGeometry
ポリゴン。
distance
: このバッファに使用された、double
としての距離値。
この値は、予定ジオメトリの予測単位と同じ単位であると見なされます。ジオメトリが測地の場合、このバッファの幅はメーターになります。
このメソッドは、Oracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。このため、spatial
リンク名を使用して、メソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
com.oracle.cep.cartridge.spatial.Geometry.bufferPolygon@spatial(geom, 1300)
詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。
例
例16-11は、bufferPolygon
メソッドの使用方法を示しています。bufferPolygon
呼出しはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストに依存するため、spatial
リンク名を使用します。
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、所与の引数から1つの要素情報値をint[]
として返します。
このメソッドは次の引数を使用します。
soffset
: この要素の第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小さくなります。ジオメトリの最後の要素は、その開始オフセットから縦座標可変長配列の最後までの縦座標によって記述されます。
表16-5は、SDO_ETYPE
とSDO_INTERPREATION
間の関係を示しています。
表16-5 SDO_ETYPEとSDO_INTERPRETATION
SDO_ETYPE | SDO_INTERPRETATION | 説明 |
---|---|---|
0 |
任意の数値 |
Oracle Spatialによってサポートされないジオメトリ・タイプのモデル化に使用します。 |
1 |
1 |
点のタイプです。 |
1 |
0 |
方向付きの点の方向です。 |
1003または2003 |
1 |
頂点が直線セグメントに連結している単純なポリゴンです。各頂点について点を指定し、ポリゴンを閉じるために、終了点と開始点が一致するように指定する必要があります(許容差内で)。 たとえば、4面のポリゴンの場合は、5番目の点が1番目の点と同じになるような5つの点を指定します。 |
例
例16-12は、createElemInfo
メソッドの使用方法を示しています。
例16-12 Geometry.createElemInfoを使用したOracle CQL問合せ
<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
メソッドは、新規の2D oracle.cep.cartridge.spatial.Geometry
オブジェクトを返します。
このメソッドは次の引数を使用します。
gtype
: int
としてのジオメトリ・タイプ。
詳細は、表16-2を参照してください。
eleminfo
: int[]
としてのジオメトリ要素情報。
詳細は、「createElemInfo」を参照してください。
ordinates
: double[]
としてのジオメトリ縦座標。
srid
: int
としてのジオメトリのオプションのSDO_SRID
。
srid
パラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。このため、spatial
リンク名を使用して、メソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
com.oracle.cep.cartridge.spatial.Geometry.createGeometry@spatial(gtype, eleminfo, ordinates)
詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。
例
例16-13は、createGeometry
メソッドの使用方法を示しています。このcreateGeometry
呼出しにはsrid
引数が含まれていないため、spatial
リンク名を使用してメソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストが関連付けられます。
例16-13 Geometry.createGeometryを使用したOracle CQL問合せ
<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
メソッドは、穴のない単純な2Dの線形ポリゴンである、新規のcom.oracle.cep.cartridge.spatial.Geometry
オブジェクトを返します。座標配列が自身では閉じない場合(最初と最後の座標が同じでない場合)、このメソッドは最初の座標をコピーし、この座標値を入力座標配列の最後に追加します。
穴のない単純な線形ポリゴンを作成するには、次の引数を使用します。
coords
: double[]
としての線形ポリゴンの座標。
srid
: int
としてのジオメトリのオプションのSRID
。
srid
パラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。このため、spatial
リンク名を使用して、メソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
com.oracle.cep.cartridge.spatial.Geometry.createLinearPolygon@spatial(coords)
詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。
例
例16-14は、createLinearPolygon
メソッドの使用方法を示しています。このcreateLinearPolygon
メソッド呼出しにはsrid
引数が含まれていないため、spatial
リンク名を使用してメソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、3Dの点である新規のcom.oracle.cep.cartridge.spatial.Geometry
オブジェクトを返します。
このメソッドは次の引数を使用します。
x
: double
としての左下のx座標。
y
: double
としての左下のy座標。
srid
: int
としてのジオメトリのオプションのSRID
。
srid
パラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。このため、spatial
リンク名を使用して、メソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(x, y)
詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。
例
例16-15は、createPoint
メソッドの使用方法を示しています。このcreatePoint
呼び出しにはsrid
引数が含まれているため、spatial
リンク名を使用する必要はありません。
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、2Dの矩形である新規のcom.oracle.cep.cartridge.spatial.Geometry
オブジェクトを返します。
このメソッドは次の引数を使用します。
x1
: double
としての左下のx座標。
y1
: double
としての左下のy座標。
x2
: double
としての右上のx座標。
y2
: double
としての右上のy座標。
srid
: int
としてのジオメトリのオプションのSRID
。
srid
パラメータを省略すると、このメソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストからパラメータを取得します。このため、spatial
リンク名を使用して、メソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
com.oracle.cep.cartridge.spatial.Geometry.createRectangle@spatial(x1, y1, x2, y2)
詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。
例
例16-16は、createRectangle
メソッドの使用方法を示しています。このcreateRectangle
メソッド呼出しにはsrid
引数が含まれていないため、spatial
リンク名を使用してメソッド呼出しとOracle Spatialデータ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、2つのジオメトリ間の距離をdouble
として計算します。
特定の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データ・カートリッジのアプリケーション・コンテキストを関連付ける必要があります。
com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom) com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom1, geom2)
詳細は、16.1.4項「Oracle Spatialデータ・カートリッジのアプリケーション・コンテキスト」を参照してください。
例
例16-17は、distance
メソッドの使用方法を示しています。distance
メソッドはOracle Spatialデータ・カートリッジのアプリケーション・コンテキストに依存するため、spatial
リンク名を使用する必要があります。
例16-17 Geometry.distanceを使用したOracle CQL問合せ
<view id="LocGeomStream" schema="customerId curLoc"> select customerId, com.oracle.cep.cartridge.spatial.Geometry.createRectangle(x1, y1, x2, y2, 8307) from CustomerLocStream where com.oracle.cep.cartridge.spatial.Geometry.distance@spatial(geom1, geom2) < 5 </view>
構文
注意: これはOracle CQL関数で、com.oracle.cep.cartridge.spatial.Geometry クラスのメソッドではないため、この関数は、例16-18のようにパッケージ接頭辞を指定せずに呼び出します。
einfogenerator@spatial
|
目的
この関数は、所与の引数から1つの要素情報値をint[]
として返します。
この関数は次の引数を使用します。
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小さくなります。ジオメトリの最後の要素は、その開始オフセットから縦座標可変長配列の最後までの縦座標によって記述されます。
表16-6は、SDO_ETYPE
とSDO_INTERPREATION
間の関係を示しています。
表16-6 SDO_ETYPEとSDO_INTERPRETATION
SDO_ETYPE | SDO_INTERPRETATION | 説明 |
---|---|---|
0 |
任意の数値 |
Oracle Spatialによってサポートされないジオメトリ・タイプのモデル化に使用します。 |
1 |
1 |
点のタイプです。 |
1 |
0 |
方向付きの点の方向です。 |
1003または2003 |
1 |
頂点が直線セグメントに連結している単純なポリゴンです。各頂点について点を指定し、ポリゴンを閉じるために、終了点と開始点が一致するように指定する必要があります(許容差内で)。 たとえば、4面のポリゴンの場合は、5番目の点が1番目の点と同じになるような5つの点を指定します。 |
例
例16-18は、oeinfogenerator
関数を使用してジオメトリの要素情報を作成する方法を示しています。
例16-18 Oracle Spatialジオメトリ・タイプを使用したOracle CQL問合せ
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>
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、次の値を含む特定のGeometry
のMBR
をdouble[][]
として返します。
[0][0]
: minX
[0][1]
: maxX
[1][0]
: minY
[1][1]
: maxY
このメソッドは次の引数を使用します。
geom
: com.oracle.cep.cartridge.spatial.Geometry
オブジェクト。
例
例16-19は、get2dMbr
メソッドの使用方法を示しています。
構文
注意: これはOracle CQL関数で、com.oracle.cep.cartridge.spatial.Geometry クラスのメソッドではないため、この関数は、例16-20のようにパッケージ接頭辞を指定せずに呼び出します。
ordsgenerator@spatial |
目的
この関数は、Oracle Spatialが要求する2D座標のdouble
配列を返します。
この関数は次の引数を使用します。
x1, y1, ... xN, yN
: double
座標値のカンマ区切りリスト。
例
例16-20は、ordsgenerator
関数を使用して、6つのdouble
座標値からOracle Spatialダブル配列を作成する方法を示しています。
例16-20 Oracle Spatialジオメトリ・タイプを使用したOracle CQL問合せ
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
メソッドは、oracle.spatial.geometry.JGeometry
タイプを3Dのcom.oracle.cep.cartridge.spatial.Geometry
タイプに変換します。指定されたジオメトリがすでにGeometry
タイプおよび3Dジオメトリである場合、変換は行われません。指定されたジオメトリが2Dのジオメトリの場合、z座標を埋め込むことでジオメトリは3Dに変換されます。
このメソッドは次の引数を使用します。
geom
: 変換するoracle.spatial.geometry.JGeometry
オブジェクト。
例
例16-21は、to_Geometry
メソッドの使用方法を示しています。
構文
目的
このcom.oracle.cep.cartridge.spatial.Geometry
メソッドは、com.oracle.cep.cartridge.spatial.Geometry
オブジェクトを2Dタイプのoracle.spatial.geometry.JGeometry
に変換します。
このメソッドは次の引数を使用します。
g
: 変換するcom.oracle.cep.cartridge.spatial.Geometry
オブジェクト。
例
例16-22は、to_JGeometry
メソッドの使用方法を示しています。