ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Complex Event Processing CQL言語リファレンス
11gリリース1 (11.1.1.6.2)
B61613-04
  目次へ移動
目次		 索引へ移動
索引
前
前 		 次
次		  

16 Oracle Spatial

この章では、Oracle Continuous Query Language (Oracle CQL)を拡張して位置情報対応型のアプリケーションに高度な空間機能を提供するOracle Spatialカートリッジを使用する場合のリファレンスとガイドを提供します。

Oracle Spatialの型、メソッド、フィールドおよびコンストラクタを、Oracle CQLのネイティブ型と同様に、Oracle CEPアプリケーションの作成時にOracle CQLの問合せおよびビューで使用できます。

この章の内容は、次のとおりです。

詳細は、以下を参照してください。

16.1 Oracle Spatialについて

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の詳細は、次の資料を参照してください。

この項の内容は、次のとおりです。

16.1.1 データ・カートリッジ名

Oracle Spatialでは、カートリッジID com.oracle.cep.cartrdiges.spatialを使用してサーバー・スコープ予約済リンク名spatialを登録します。

spatialリンク名を使用して、Oracle Spatialのメソッド呼出しとOracle Spatialのアプリケーション・コンテキストを関連付けます。

詳細は、以下を参照してください。

16.1.2 有効範囲

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の次のジオメトリ・タイプ:

  • 2Dの点

  • 2Dの単純ポリゴン

  • 2Dの矩形

次のジオメトリ操作:

  • ジオメトリ・タイプの作成

  • ジオメトリ・タイプのpublicメンバー関数およびpublicフィールドへのアクセス

詳細は、以下を参照してください。

座標系

  • デカルトおよびWGS84測地座標(デフォルト)

  • SRIDによるデフォルト座標系の指定

  • 他の測地座標の使用

詳細は、16.1.2.3項「縦座標および座標系とSDO_SRID」を参照してください。

ジオメトリ索引

  • Rツリー

詳細は、16.1.2.4項「ジオメトリ索引」を参照してください。

ジオメトリ関係演算子

詳細は、16.1.2.5項「ジオメトリ関係演算子」を参照してください。

ジオメトリ・フィルタ演算子

詳細は、16.1.2.6項「ジオメトリ・フィルタ演算子」を参照してください。

ジオメトリAPI

com.oracle.cep.cartridge.spatial.Geometryで提供されているメソッドの完全なリストは、16.1.2.7項「ジオメトリAPI」を参照してください。

Oracle Spatialを使用してこれらのOracle Spatial機能にアクセスする方法の詳細は、16.2項「Oracle Spatialの使用」を参照してください。

16.1.2.1 ジオメトリ・タイプ

Oracle Spatialのデータ・モデルはジオメトリで構成されます。ジオメトリは、順序の付いた一連の頂点です。ジオメトリのセマンティクスは、そのタイプによって決まります。

Oracle Spatialを使用すると、Oracle CQLの問合せとビューで次のOracle Spatialタイプに直接アクセスできます。

  • SDO_GTYPES: Oracle Spatialは次のジオメトリ・タイプをサポートしています。

    • 2Dの点

    • 2Dの単純ポリゴン

    • 2Dの矩形

    表16-2は、使用可能なcom.oracle.cep.cartridge.spatial.Geometryクラスのジオメトリ・タイプを示しています。

    表16-2 Oracle Spatialジオメトリ・タイプ

    ジオメトリ・タイプ 説明

    GTYPE_POINT

    1つの点を含む点ジオメトリ・タイプ。

    GTYPE_POLYGON

    1つのポリゴンを含むポリゴン・ジオメトリ・タイプ。

  • SDO_ELEMENT_INFO: 次の項目を使用して、要素情報配列を作成できます。

    • com.oracle.cep.cartridge.spatial.Geometry.createElemInfo静的メソッド

    • einfogenerator関数

    詳細は、16.1.2.2項「要素情報配列」を参照してください。

  • ORDINATES: Oracle Spatialのordsgenerator関数を使用して、縦座標を作成できます。

    詳細は、16.1.2.3項「縦座標および座標系とSDO_SRID」を参照してください。

詳細は、以下を参照してください。

16.1.2.2 要素情報配列

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関数を使用することもできます。

詳細は、以下を参照してください。

16.1.2.3 縦座標および座標系とSDO_SRID

表16-3は、Oracle Spatialでデフォルトでサポートされる座標系、および各座標系を識別するSDO_SRID値を示しています。

表16-3 Oracle Spatialの座標系

座標系 SDO_SRID 説明

デカルト

0

デカルト座標は、指定した基点からの点の位置を、空間の直交する軸を関連付けて測定する座標です。

測地(WGS84)

8307

測地座標(地理座標)は、角度を持つ座標(経度および緯度)で、球体の極点の座標と密接に関連しており、地球上の特定の測地データに関連付けて定義されます。

これは、Oracle Spatialのデフォルトの座標系です。

SDO_SRIDの値は、呼び出すOracle Spatialのメソッドおよびコンストラクタのそれぞれに引数として指定できます。または、SDO_SRIDをOracle Spatialのアプリケーション・コンテキストに一度だけ構成し、毎回引数として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)

かわりに、spatialリンク名を使用して、メソッド呼出しをOracle Spatialのアプリケーション・コンテキストと関連付ける必要があります。

com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat)

SDO_SRID値を使用するGeometryメソッドを使用する場合、spatialリンク名の使用はオプションです。たとえば、次のメソッド呼出しは両方とも有効です。

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」を参照してください。

詳細は、以下を参照してください。

16.1.2.4 ジオメトリ索引

Oracle Spatialでは空間索引を使用して、1次フィルタを実装します。空間索引の目的は、データのサブセットを迅速に作成し、2次フィルタでの処理の負荷を軽減することです。

空間索引は他の索引と同様、検索対象を限定するメカニズムを提供しますが、この場合は、メカニズムは交差や包含のような空間基準に基づきます。

Oracle Spatialでは、デフォルトの索引作成メカニズムにRツリー索引を使用しています。空間Rツリー索引では、最大4次元の空間データの索引を作成できます。Rツリー索引では、ジオメトリを囲む最小の矩形(最小境界矩形(MBR))によって各ジオメトリを近似させます。

詳細は、以下を参照してください。

16.1.2.5 ジオメトリ関係演算子

Oracle Spatialでは、次のOracle Spatialジオメトリ関係演算子がサポートされます。

これらの操作はすべて、Oracle CQL問合せのprojection句またはwhere句のいずれかに使用できます。

Oracle CQL問合せのwhere句でジオメトリ関係演算子を使用する場合、Oracle Spatialで、where句で指定された関係に対してRツリー索引を作成できます。

Oracle Spatialでは、点と他のジオメトリ・タイプ間のジオメトリ関係のみがサポートされます。

詳細は、16.2.4項「ジオメトリ関係演算子の使用方法」を参照してください。

16.1.2.6 ジオメトリ・フィルタ演算子

Oracle Spatialでは、次のOracle Spatialジオメトリ・フィルタ演算子がサポートされます。

これらのフィルタ演算子では一時フィルタが実行されるので、Oracle CQL問合せのwhere句でのみ使用されます。

これらのフィルタ演算子では空間索引を使用して、指定するオブジェクトと空間的に対話する可能性がある一連の空間オブジェクトが識別されます。

詳細は、以下を参照してください。

16.1.2.7 ジオメトリAPI

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からアクセスすることはできません。

この項の内容は、次のとおりです。

詳細は、以下を参照してください。


注意:

Oracle Spatialの型名を簡易化するために、2.7.2項「Aliases要素を使用した別名の定義」に示すように別名を使用できます。

16.1.2.7.1 com.oracle.cep.cartridge.spatial.Geometryメソッド

表16-4は、Geometryクラスで提供されるパブリック・メソッドを示しています。

表16-4 Oracle Spatialジオメトリ・メソッド

型 メソッド

バッファ

距離

要素情報

ジオメトリ

線形ポリゴン

最小境界矩形(MBR)

点

矩形

型および型変換


注意:

Geometryクラスでは大文字と小文字が区別されるため、表示されている方を使用してください。


注意:

SDO_SRID値を使用しないcom.oracle.cep.cartridge.spatial.Geometryメソッドを使用する場合、Oracle Spatialのアプリケーション・コンテキストを使用する必要があります。たとえば、次のメソッド呼出しを行うとランタイム例外が発生します。

com.oracle.cep.cartridge.spatial.Geometry.createPoint(lng, lat)

かわりに、spatialリンク名を使用して、メソッド呼出しをOracle Spatialのアプリケーション・コンテキストと関連付ける必要があります。

com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat)

SDO_SRID値を使用するGeometryメソッドを使用する場合、spatialリンク名の使用はオプションです。たとえば、次のメソッド呼出しは両方とも有効です。

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のアプリケーション・コンテキスト」を参照してください。

16.1.2.7.2 oracle.spatial.geometry.JGeometryメソッド

次のJGeometryパブリック・メソッドを、Oracle Spatialに適用できます。

  • double area(double tolerance): 2Dジオメトリの平面の表面積合計を返します。

  • double length(double tolerance): 2Dジオメトリの周辺の長さを返します。すべての辺の長さが加えられます。

  • double[] getMBR(): このジオメトリの最小境界矩形(MBR)を返します。2DのMBRのminX、minY、maxXおよびmaxY値を含むダブル配列を返します。

詳細は、以下を参照してください。

16.1.3 データ型マッピング

Oracle Spatialカートリッジは、1つのデータ型com.oracle.cep.cartridge.spatial.Geometryをサポートしています。

com.oracle.cep.cartridge.spatial.Geometryで提供されているメソッドの完全なリストは、16.1.2.7項「ジオメトリAPI」を参照してください。

16.1.4 Oracle Spatialのアプリケーション・コンテキスト

Oracle Spatialのインスタンスにアプリケーション・コンテキストを定義し、このアプリケーション・コンテキストをランタイム時に伝播できます。これにより、特定のOracle Spatialアプリケーション・デフォルト(SDO_SRIDなど)を特定のOracle Spatialインスタンスに関連付けることができます。

Oracle Spatialのアプリケーション・コンテキストを定義する前に、例16-1に示すように、必須のネームスペースおよびスキーマの場所のエントリを追加するように、Oracle CEPアプリケーションEPNアセンブリ・ファイルを編集します。

例16-1 EPNアセンブリ・ファイル: Oracle Spatialネームスペースおよびスキーマの場所

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:osgi="http://www.springframework.org/schema/osgi"
       xmlns:wlevs="http://www.bea.com/ns/wlevs/spring"
       xmlns:spatial="http://www.oracle.com/ns/ocep/spatial"
       xsi:schemaLocation="
  http://www.springframework.org/schema/beans
  http://www.springframework.org/schema/beans/spring-beans.xsd
  http://www.springframework.org/schema/osgi
  http://www.springframework.org/schema/osgi/spring-osgi.xsd
  http://www.bea.com/ns/wlevs/spring
  http://www.bea.com/ns/wlevs/spring/spring-wlevs-v11_1_1_6.xsd"
  http://www.oracle.com/ns/ocep/spatial
  http://www.oracle.com/ns/ocep/spatial/ocep-spatial.xsd">

例16-2は、測地参照システム1980 (GRS80)座標系を使用して、SpatialGRS80という空間コンテキストをEPNアセンブリ・ファイルに作成する方法を示しています。

例16-2 EPNアセンブリ・ファイルのspatial:context要素

<spatial:context id="SpatialGRS80" srid="4269" sma="6378137" rof="298.25722101" />

例16-3は、Oracle CQL問合せでspatial:contextを参照する方法を示しています。この例では、問合せは(例16-2で定義された)リンク名SpatialGRS80を使用して、このアプリケーション・コンテキストをOracle Spatialに伝播しています。SpatialGRS80のspatial:context属性設定は、createPointメソッド呼出しに適用されます。

例16-3 Oracle CQL問合せでのspatial:contextの参照

<view  id="createPoint">
    select com.oracle.cep.cartridge.spatial.Geometry.createPoint@SpatialGRS80(
        lng, lat)
    from CustomerPos[NOW]
</view>

詳細は(すべてのspatial:context属性の完全なリストなど)、『Oracle Fusion Middleware Oracle Complex Event Processing開発者ガイド for Eclipse』のOracle Spatialのアプリケーション・コンテキストの構成方法に関する項を参照してください。


注意:

SDO_SRID値を使用しないcom.oracle.cep.cartridge.spatial.Geometryメソッドを使用する場合、Oracle Spatialのアプリケーション・コンテキストを使用する必要があります。たとえば、次のメソッド呼出しを行うとランタイム例外が発生します。

com.oracle.cep.cartridge.spatial.Geometry.createPoint(lng, lat)

かわりに、spatialリンク名を使用して、メソッド呼出しをOracle Spatialのアプリケーション・コンテキストと関連付ける必要があります。

com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat)

SDO_SRID値を使用するGeometryメソッドを使用する場合、spatialリンク名の使用はオプションです。たとえば、次のメソッド呼出しは両方とも有効です。

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」を参照してください。

16.2 Oracle Spatialの使用

この項では、Oracle CEPアプリケーションでOracle Spatialをどのように使用できるかを中心に、一般的な使用例を説明します。内容は次のとおりです。

詳細は、16.1.2.7項「ジオメトリAPI」を参照してください。

16.2.1 Oracle Spatial Java APIでサポートされているジオメトリ・タイプへのアクセス方法

次の手順では、Oracle CQL問合せでOracle Spatialを使用してOracle Spatialジオメトリ・タイプSDO_GTYPE、SDO_ELEMENT_INFOおよびORDINATESにアクセスする方法について説明します。

Oracle Spatial Java APIでサポートされているジオメトリ・タイプにアクセスするには:

  1. パッケージcom.oracle.cep.cartridge.spatialをお使いのOracle CEPアプリケーションのMANIFEST.MFファイルにインポートします。

    詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing開発者ガイド for Eclipse』のパッケージのインポート方法に関する項を参照してください。

  2. 適切なOracle Spatialデータ型を使用して、Oracle CEPアプリケーションのイベント・タイプを定義します。

    例16-4に、com.oracle.cep.cartridge.spatial.Geometry型の2つのイベント・プロパティxおよびyを使用して、イベント・タイプMySpatialEventを定義する方法を示します。

    例16-4 Oracle Spatial型を使用したOracle CEPイベント

    <wlevs:event-type-repository>
    <wlevs:event-type type-name="MySpatialEvent">
        <wlevs:properties>
            <wlevs:property name="x" type="com.oracle.cep.cartridge.spatial.Geometry"/>
            <wlevs:property name="y" type="com.oracle.cep.cartridge.spatial.Geometry"/>
        </wlevs:properties>
    </wlevs:event-type>
</wlevs:event-type-repository>

    次のように、Oracle CQL問合せでこれらのイベント・プロパティを使用できます。

    CONTAIN@spatial(x, y, 20.0d)

    詳細は、『Oracle Fusion Middleware Oracle Complex Event Processing開発者ガイド for Eclipse』のOracle CEPイベントの概要に関する項を参照してください。

  3. GTYPE_POLYGONなどのSDO_GTYPEを選択します。

    詳細は、16.1.2.1項「ジオメトリ・タイプ」を参照してください。

  4. 縦座標に適した要素情報を選択します。

    詳細は、16.1.2.2項「要素情報配列」を参照してください。

  5. 座標の値を指定します。

    詳細は、16.1.2.3項「縦座標および座標系とSDO_SRID」を参照してください。

  6. 例16-5に示すように、Oracle CQL問合せを作成します。

    例16-5 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>

16.2.2 ジオメトリの作成方法

次のメソッドを呼び出すことで、Oracle Spatialを使用してOracle CQL問合せでジオメトリを作成できます。

  • com.oracle.cartridge.spatial.Geometryの静的メソッド

  • Oracle Spatialがサポートする有効範囲およびジオメトリ・タイプに準拠している、oracle.spatial.geometry.JGeometryのメソッド。

詳細は、16.1.2.7項「ジオメトリAPI」を参照してください。

Oracle Spatialジオメトリ・クラスでの静的メソッドの使用

例16-6は、com.oracle.cartridge.spatial.Geometryの静的メソッドを使用して点ジオメトリを作成する方法を示しています。この例では、リンク(@spatial)を使用して、このクラスを提供するデータ・カートリッジを識別する必要があります。この方法の利点は、デフォルトで、または構成したアプリケーション・コンテキストに基づいて、Oracle Spatialのアプリケーション・コンテキストが適用され、SRIDおよび他のOracle Spatialオプションが設定される点です(16.1.4項「Oracle Spatialのアプリケーション・コンテキスト」を参照)。

例16-6 ジオメトリ静的メソッドを使用した点ジオメトリの作成

<view  id="CustomerPosGeom">
    select com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(
        lng, lat) as geom
    from CustomerPos[NOW]
</view>

詳細は、16.1.2.1項「ジオメトリ・タイプ」を参照してください。

16.2.3 ジオメトリ・タイプのpublicメソッドおよびフィールドへのアクセス方法

Oracle Spatialを使用すると、Oracle CQLでOracle Spatialクラスのpublicメンバー関数およびpublicメンバー・フィールドに直接アクセスできます。

Geometryクラスからアクセスできない(またはOracle Spatialがサポートする有効範囲およびジオメトリ・タイプに準拠していない)Oracle Spatial機能に、Oracle Spatialからアクセスすることはできません。

例16-7では、ビューShopGeomはgeomというOracle Spatialジオメトリを作成しています。ビューshopMBRはJGeometry静的メソッドgetMBRを呼び出し、double[]がストリーム要素mbrとして返されています。問合せqshopMBRは標準Java APIを使用してこのdouble[]にアクセスしています。

例16-7 ジオメトリ・タイプの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>

詳細は、以下を参照してください。

16.2.4 ジオメトリ関係演算子の使用方法

Oracle Spatialを使用すると、Oracle CQL問合せのWHERE句またはSELECT句で、次のOracle Spatialジオメトリ関係演算子にアクセスできます。

例16-8において、ビューop_in_whereでは、WHERE句でCONTAINジオメトリ関係演算子を使用しています。この場合、Oracle SpatialではRツリー索引を使用します。ビューop_in_projでは、SELECT句でCONTAINを使用しています。

例16-8 ジオメトリ関係演算子の使用

<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.5項「ジオメトリ関係演算子」を参照してください。

16.2.5 ジオメトリ・フィルタ演算子の使用方法

Oracle Spatialを使用すると、Oracle CQL問合せのWHERE句で、次のOracle Spatialジオメトリ・フィルタ演算子にアクセスできます。

例16-9では、ビューfilterはWHEREでFILTERジオメトリ・フィルタ演算子を使用しています。

例16-9 ジオメトリ・フィルタ演算子の使用

<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.6項「ジオメトリ・フィルタ演算子」を参照してください。

16.2.6 デフォルトの測地座標の使用方法

Oracle Spatialのデフォルトのアプリケーション・コンテキストを使用してOracle CQL問合せを作成すると、デフォルトのSRIDがCARTESIANに設定されます。

例16-10に示すように、createPointメソッド呼出しはデフォルトのリンク(@spatial)を使用します。これにより、Oracle Spatialのデフォルトのアプリケーション・コンテキストが適用されるようになります。

例16-10 Oracle CQL問合せでのデフォルトの測地座標の使用

<view  id="createPoint">
    select com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(
        lng, lat)
    from CustomerPos[NOW]
</view>

詳細は、以下を参照してください。

16.2.7 他の測地座標の使用方法

次の手順では、Oracle Spatialのアプリケーション・コンテキストを使用して、デフォルトのデカルト測地座標系以外の測地座標系をOracle CQL問合せで指定する方法について説明します。

詳細は、以下を参照してください。

他の測地座標を使用するには:

  1. Oracle Spatialのアプリケーション・コンテキストを作成し、使用する測地座標のsrid属性を定義します。

    例16-11は、測地参照システム1980 (GRS80)座標系を使用して、SpatialGRS80という空間コンテキストをEPNアセンブリ・ファイルに作成する方法を示しています。

    例16-11 EPNアセンブリ・ファイルのspatial:context要素

    <spatial:context id="SpatialGRS80" srid="4269" sma="6378137" rof="298.25722101" />

  2. Oracle CQL問合せにおいて、リンクでこのspatial:contextのIDを使用します。

    例16-12は、Oracle CQL問合せでspatial:contextを参照する方法を示しています。この例では、問合せは(例16-11で定義された)リンク名SpatialGRS80を使用して、このアプリケーション・コンテキストをOracle Spatialに伝播しています。SpatialGRS80のspatial:context属性設定は、createPointメソッド呼出しに適用されます。

    例16-12 Oracle CQL問合せでのspatial:contextの参照

    <view  id=”createPoint”>
    select com.oracle.cep.cartridge.spatial.Geometry.createPoint@SpatialGRS80(
        lng, lat)
    from CustomerPos[NOW]
</view>

ANYINTERACT

構文

anyinteract.pngについては周囲のテキストで説明しています。

注意:

これは、Oracle Spatialジオメトリ関係演算子であり、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないので、例16-13に示すように、パッケージ接頭辞を指定せずにこの演算子を呼び出すことができます。

ANYINTERACT@spatial

目的

この演算子は、GTYPE_POINTがジオメトリと対話する場合にtrueを返し、それ以外の場合はfalseを返します。

この演算子は次の引数を使用します。

詳細は、『Oracle Spatial開発者ガイド』のSDO_ANYINTERACTに関する項を参照してください。

例

例16-27は、Oracle CQL問合せでANYINTERACT Oracle Spatialジオメトリ関係演算子を使用する方法を示します。

例16-13 ジオメトリ関係演算子ANYINTERACTを使用したOracle CQL問合せ

<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>

bufferPolygon

構文

bufferpolygon.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、入力oracle.spatial.geometry.JGeometryポリゴンのバッファされたバージョンである、新規のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。

このメソッドは次の引数を使用します。

このメソッドは、Oracle Spatialのアプリケーション・コンテキストからパラメータを取得します。このため、spatialリンク名を使用して、メソッド呼出しとOracle Spatialのアプリケーション・コンテキストを関連付ける必要があります。

com.oracle.cep.cartridge.spatial.Geometry.bufferPolygon@spatial(geom, 1300)

詳細は、16.1.4項「Oracle Spatialのアプリケーション・コンテキスト」を参照してください。

例

例16-14は、bufferPolygonメソッドの使用方法を示しています。bufferPolygon呼出しはOracle Spatialのアプリケーション・コンテキストに依存するため、spatialリンク名を使用します。

例16-14 Geometry.bufferPolygonを使用したOracle CQL問合せ

<view id="LocGeomStream" schema="customerId curLoc">
    select 
        customerId, 
        com.oracle.cep.cartridge.spatial.Geometry.bufferPolygon@spatial(geom, 13) 
    from 
        CustomerLocStream
</view>

CONTAIN

構文

contain.pngについては周囲のテキストで説明しています。

注意:

これは、Oracle Spatialジオメトリ関係演算子であり、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないので、例16-13に示すように、パッケージ接頭辞を指定せずにこの演算子を呼び出すことができます。

CONTAIN@spatial

目的

この演算子は、GTYPE_POINTがジオメトリに含まれる場合にtrueを返し、それ以外の場合はfalseを返します。

この演算子は次の引数を使用します。

詳細は、『Oracle Spatial開発者ガイド』のSDO_CONTAINSに関する項を参照してください。

例

例16-27は、Oracle CQL問合せでCONTAIN Oracle Spatialジオメトリ関係演算子を使用する方法を示します。

例16-15 ジオメトリ関係演算子CONTAINを使用したOracle CQL問合せ

<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>

createElemInfo

構文

createeleminfo.pngについては周囲のテキストで説明しています。

注意:

関数einfogeneratorを使用することもできます。詳細は、「einfogenerator」を参照してください。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、所与の引数から1つの要素情報値をint[]として返します。

このメソッドは次の引数を使用します。

例

例16-16は、createElemInfoメソッドの使用方法を示しています。

例16-16 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>

createGeometry

構文

creategeometry.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、新規の2D oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。

このメソッドは次の引数を使用します。

例

例16-17は、createGeometryメソッドの使用方法を示しています。このcreateGeometry呼出しにはsrid引数が含まれていないため、spatialリンク名を使用してメソッド呼出しとOracle Spatialのアプリケーション・コンテキストが関連付けられます。

例16-17 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>

createLinearPolygon

構文

createlinearpolygon.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、穴のない単純な2Dの線形ポリゴンである、新規のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。座標配列が自身では閉じない場合(最初と最後の座標が同じでない場合)、このメソッドは最初の座標をコピーし、この座標値を入力座標配列の最後に追加します。

穴のない単純な線形ポリゴンを作成するには、次の引数を使用します。

例

例16-18は、createLinearPolygonメソッドの使用方法を示しています。このcreateLinearPolygonメソッド呼出しにはsrid引数が含まれていないため、spatialリンク名を使用してメソッド呼出しとOracle Spatialのアプリケーション・コンテキストを関連付ける必要があります。

例16-18 Geometry.createLinearPolygonを使用したOracle CQL問合せ

<view id="LocGeomStream" schema="customerId curLoc">
    select 
        customerId, 
        com.oracle.cep.cartridge.spatial.Geometry.createLinearPolygon@spatial(coords) 
    from 
        CustomerLocStream
</view>

createPoint

構文

createpoint.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、3Dの点である新規のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。

このメソッドは次の引数を使用します。

例

例16-19は、createPointメソッドの使用方法を示しています。このcreatePoint呼出しにはsrid引数が含まれているため、spatialリンク名を使用する必要はありません。

例16-19 Geometry.createPointを使用したOracle CQL問合せ

<view id="LocGeomStream" schema="customerId curLoc">
    select 
        customerId, 
        com.oracle.cep.cartridge.spatial.Geometry.createPoint@spatial(lng, lat) 
    from 
        CustomerLocStream
</view>

createRectangle

構文

createrectangle.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、2Dの矩形である新規のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトを返します。

このメソッドは次の引数を使用します。

例

例16-20は、createRectangleメソッドの使用方法を示しています。このcreateRectangleメソッド呼出しにはsrid引数が含まれていないため、spatialリンク名を使用してメソッド呼出しとOracle Spatialのアプリケーション・コンテキストを関連付ける必要があります。

例16-20 Geometry.createRectangleを使用したOracle CQL問合せ

<view id="LocGeomStream" schema="customerId curLoc">
    select 
        customerId, 
        com.oracle.cep.cartridge.spatial.Geometry.createRectangle@spatial(x1, y1, x2, y2) 
    from 
        CustomerLocStream
</view>

distance

構文

distance.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、2つのジオメトリ間の距離をdoubleとして計算します。

特定のcom.oracle.cep.cartridge.spatial.Geometryオブジェクトと他との間の距離を計算するには、次の引数を指定して、現在のGeometryオブジェクトの静的でないdistanceメソッドを使用します。

2つのcom.oracle.cep.cartridge.spatial.Geometryオブジェクト間の距離を計算するには、次の引数を指定して静的なdistanceメソッドを使用します。

どちらの場合も、このメソッドは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-21は、distanceメソッドの使用方法を示しています。distanceメソッドはOracle Spatialのアプリケーション・コンテキストに依存するため、spatialリンク名を使用する必要があります。

例16-21 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>

einfogenerator

構文

einfogenerator.pngについては周囲のテキストで説明しています。

注意:

これはOracle CQL関数で、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないため、この関数は、例16-22のようにパッケージ接頭辞を指定せずに呼び出します。

einfogenerator@spatial

GeometryメソッドcreateElemInfoを使用することもできます。詳細は、「createElemInfo」を参照してください。

目的

この関数は、所与の引数から1つの要素情報値をint[]として返します。

この関数は次の引数を使用します。

例

例16-22は、oeinfogenerator関数を使用してジオメトリの要素情報を作成する方法を示しています。

例16-22 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>

FILTER

構文

filter.pngについては周囲のテキストで説明しています。

注意:

これは、Oracle Spatialジオメトリ・フィルタ演算子であり、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないので、例16-13に示すように、パッケージ接頭辞を指定せずにこの演算子を呼び出すことができます。

FILTER@spatial

目的

この演算子は、切り離されていないオブジェクトのペアの場合はtrueを返し、それ以外の場合はfalseを返します。

この演算子は次の引数を使用します。

詳細は、『Oracle Spatial開発者ガイド』のSDO_FILTERに関する項を参照してください。

例

例16-27は、Oracle CQL問合せでFILTER Oracle Spatialジオメトリ・フィルタ演算子を使用する方法を示します。

例16-23 ジオメトリ関係演算子FILTERを使用したOracle CQL問合せ

<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>

get2dMbr

構文

get2dmbr.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、次の値を含む特定のGeometryの最小境界矩形(MBR)をdouble[][]として返します。

このメソッドは次の引数を使用します。

例

例16-24は、get2dMbrメソッドの使用方法を示しています。

例16-24 Geometry.get2dMbrを使用したOracle CQL問合せ

<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>

INSIDE

構文

inside.pngについては周囲のテキストで説明しています。

注意:

これは、Oracle Spatialジオメトリ関係演算子であり、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないので、例16-13に示すように、パッケージ接頭辞を指定せずにこの演算子を呼び出すことができます。

INSIDE@spatial

目的

この演算子は、GTYPE_POINTがジオメトリに含まれる場合にtrueを返し、それ以外の場合はfalseを返します。

この演算子は次の引数を使用します。

詳細は、『Oracle Spatial開発者ガイド』のSDO_INSIDEに関する項を参照してください。

例

例16-27は、Oracle CQL問合せでINSIDE Oracle Spatialジオメトリ関係演算子を使用する方法を示します。

例16-25 ジオメトリ関係演算子INSIDEを使用した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>

NN

構文

nn.pngについては周囲のテキストで説明しています。

注意:

これは、Oracle Spatialジオメトリ・フィルタ演算子であり、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないので、例16-13に示すように、パッケージ接頭辞を指定せずにこの演算子を呼び出すことができます。

NN@spatial

目的

この演算子は、keyに最も近いgeomからオブジェクト(最も近くにあるネイバー)を返します。2つのジオメトリ・オブジェクトの近さを決定する際、各オブジェクトの表面上の2点間の最短距離が使用されます。

この関数は次の引数を使用します。

詳細は、『Oracle Spatial開発者ガイド』のSDO_NNに関する項を参照してください。

例

例16-27は、Oracle CQL問合せでNN Oracle Spatialジオメトリ・フィルタ演算子を使用する方法を示します。

例16-26 ジオメトリ関係演算子NNを使用した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>

ordsgenerator

構文

ordsgenerator.pngについては周囲のテキストで説明しています。

注意:

これはOracle CQL関数で、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないため、この関数は、例16-27のようにパッケージ接頭辞を指定せずに呼び出します。

ordsgenerator@spatial

目的

この関数は、Oracle Spatialが要求する2D座標のdouble配列を返します。

この関数は次の引数を使用します。

例

例16-27は、ordsgenerator関数を使用して、6つのdouble座標値からOracle Spatialダブル配列を作成する方法を示しています。

例16-27 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>

to_Geometry

構文

to_geometry.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、oracle.spatial.geometry.JGeometryタイプを3Dのcom.oracle.cep.cartridge.spatial.Geometryタイプに変換します。指定されたジオメトリがすでにGeometryタイプおよび3Dジオメトリである場合、変換は行われません。指定されたジオメトリが2Dのジオメトリの場合、z座標を埋め込むことでジオメトリは3Dに変換されます。

このメソッドは次の引数を使用します。

例

例16-28は、to_Geometryメソッドの使用方法を示しています。

例16-28 Geometry.to_Geometryを使用したOracle CQL問合せ

<view id="LocStream" schema="customerId loc">
    select 
        customerId, 
        com.oracle.cep.cartridge.spatial.Geometry.to_Geometry(geom) 
    from 
        CustomerLocStream
</view>

to_JGeometry

構文

to_jgeometry.pngについては周囲のテキストで説明しています。

目的

このcom.oracle.cep.cartridge.spatial.Geometryメソッドは、com.oracle.cep.cartridge.spatial.Geometryオブジェクトを2Dタイプのoracle.spatial.geometry.JGeometryに変換します。

このメソッドは次の引数を使用します。

例

例16-29は、to_JGeometryメソッドの使用方法を示しています。

例16-29 Geometry.to_JGeometryを使用したOracle CQL問合せ

<view id="LocStream" schema="customerId loc">
    select 
        customerId, 
        com.oracle.cep.cartridge.spatial.Geometry.to_JGeometry(geom) 
    from 
        CustomerLocStream
</view>

WITHINDISTANCE

構文

withindistance.pngについては周囲のテキストで説明しています。

注意:

これは、Oracle Spatialジオメトリ関係演算子であり、com.oracle.cep.cartridge.spatial.Geometryクラスのメソッドではないので、例16-13に示すように、パッケージ接頭辞を指定せずにこの演算子を呼び出すことができます。

WITHINDISTANCE@spatial

目的

この演算子は、GTYPE_POINTがジオメトリの特定の距離内にある場合にtrueを返し、それ以外の場合はfalseを返します。

この演算子は次の引数を使用します。

詳細は、『Oracle Spatial開発者ガイド』のSDO_WITHIN_DISTANCEに関する項を参照してください。

例

例16-27は、Oracle CQL問合せでWITHINDISTANCE Oracle Spatialジオメトリ関係演算子を使用する方法を示します。

例16-30 ジオメトリ関係演算子WITHINDISTANCEを使用したOracle CQL問合せ

<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>
  前
前 		 次
次
  目次へ移動
目次		 索引へ移動
索引