1. 開発者ガイド
  2. 空間Webサービス
  3. SpatialのWebサービスの概要

11 空間Webサービスの概要

この章では、Oracle Spatial and GraphでサポートされるWebサービスについて説明します。

ノート:

Oracle Cloud MarketplaceからOracle Spatial Webサービスをデプロイできます。このパッケージ・アプリケーションを使用すると、Oracle Cloud Infrastructure (OCI)上のApache Tomcat Webサーバー・インスタンスにデプロイされたOracle Spatial Webサービス(Web Feature Service (WFS)、Web Coverage Services (WCS)およびCatalog Services for the Web (CSW))をインストールできます。

Webサービスを使用すると、Oracle Spatial and Graphアプリケーションの開発者は、アプリケーション・ユーザーに対してフィーチャ・データおよびメタデータをWeb経由で提供できます。

ノート:

Spatial and GraphのWeb Feature Service (WFS)のサポートまたはCatalog Services for the Web (CSW)のサポートを使用している場合、および1つ以上のSYS.XMLTABLEINDEXの索引を使用して索引付けされた以前のリリースのデータがある場合は、アップグレード前に関連付けられた索引を削除し、アップグレード後に索引を再作成する必要があります。

詳細は、「アップグレード前およびアップグレード後に行う索引のメンテナンス(WFSおよびCSW)」を参照してください。

  • 空間Webサービスの種類
    Oracle Spatial and Graphでは、次の種類のWebサービスが提供されます。
  • 空間Webサービスのユーザーの種類
    「ユーザー」という語の意味が一般的なビジネス上の意味だとすると、空間Webサービス・アプリケーションの実装には次の種類のユーザーが関与します。
  • 空間Webサービスのデプロイと構成
    このトピックでは、空間Webサービス、特にWFS、WCSおよびCSWのデプロイおよび構成で行う処理について説明します。
  • 空間Webサービスの管理コンソール
    Oracle Spatial and Graphには、空間Webサービスの管理コンソールが用意されています。管理コンソールはいくつかのコンポーネントで構成されており、WFS、WCSおよびCSW Webサービス・エンジンを構成したり、各サービスをテストしたり、エラー・ログを表示して診断したりできます。これは、sdows.earファイル内に含まれています。

親トピック: 空間Webサービス

11.1 空間Webサービスの種類

Oracle Spatial and Graphでは、次の種類のWebサービスが提供されます。

  • ジオコーディング: ユーザーは、住所を空間位置(経度と緯度の座標)に関連付けることができます。ジオコーディングのサポートについては、「住所データのジオコーディング」を参照してください。

  • イエロー・ページ: ユーザーは位置との関係に基づいて、名前別またはカテゴリ別にビジネス情報を検索できます。イエロー・ページのサポートについては、「ビジネス・ディレクトリ(イエロー・ページ)のサポート」を参照してください。

  • ルーティング: 1つまたは複数のルートについて道路情報や案内を提供します。ルーティングのサポートについては、「ルーティング・エンジン」を参照してください。

  • OpenLS: ジオコーディング、マッピング、ルーティングおよびイエロー・ページに対するOpen Location Services Initiative(OpenLS)仕様に基づいて、位置情報をベースにしたサービスを提供します。OpenLSのサポートについては、「OpenLSのサポート」を参照してください。

  • Web Feature Services(WFS): ユーザーは、位置または非空間属性との関係に基づいて、フィーチャ(道路、川など)を検索できます。WFSのサポートについては、「Web Feature Service (WFS)のサポート」を参照してください。

  • Web Coverage Service (WCS): クライアント側レンダリング、科学的モデルへの入力および他のクライアントに有用な形式のカバレッジ・データへのアクセスを提供します。WCSのサポートについては、「Web Coverage Service (WCS)のサポート」を参照してください。

    WCSの概要については、https://en.wikipedia.org/wiki/Web_Coverage_Serviceを参照してください。WCSと関連するWebサービスとの簡単な比較については、http://gis.stackexchange.com/questions/80948/what-are-the-differences-between-wms-wfs-wcs-wpsを参照してください。

  • Catalog Services for the Web (CSW): カタログ・サービスに対するOpen GIS Consortium仕様のOracle Spatial and Graphの実装を記述します。この仕様によると、カタログ・サービスは、データ、サービスおよび関連する情報オブジェクトについての記述情報(メタデータ)の集合をパブリッシュおよび検索する機能をサポートしています。CSWのサポートについては、「Catalog Services for the Web(CSW)のサポート」を参照してください。

  • Web Map Service (WMS): 空間データのレンダリングをサポートします。具体的には、WMS 1.1.1および1.3.0実装仕様がマップ視覚化コンポーネントに実装されています。この実装については、『Oracle Spatial and Graphマップ・ビジュアライゼーション開発者ガイド』の「マップ視覚化コンポーネントでのOGC WMSサポート」を参照してください。

親トピック: 空間Webサービスの概要

11.2 空間Webサービスのユーザーの種類

「ユーザー」という語の意味が一般的なビジネス上の意味だとすると、空間Webサービス・アプリケーションの実装には次の種類のユーザーが関与します。

  • Webサービスのインフラストラクチャを設定する管理者。管理者は、データベース・ユーザーの作成、新規および既存のデータベース・ユーザーに対する権限とアクセス権の付与、複数のデータベース・ユーザーに影響するその他の操作などを行います。

    • Web Feature Serviceの場合、管理者はWFS管理コンソールを使用してフィーチャ表の登録、フィーチャ・タイプのパブリッシュを行います。

    • Catalog Service for the Webサービスの場合、管理者はCSW管理コンソールを使用してレコード・タイプをパブリッシュします。

    • Web Coverage Serviceの場合、管理者はWCS管理コンソールを使用してカバレッジをパブリッシュします。

    たとえば、管理者は、インフラストラクチャを設定して、道路や川などの空間フィーチャにアクセスできるようにします。

  • 空間データおよびメタデータを作成および管理するアプリケーション開発者。開発者は、空間データ表を作成し、空間索引を作成して、行をUSER_SDO_GEOM_METADATAビューに挿入し、空間のファンクションおよびプロシージャを使用してアプリケーション・ロジックを実装します。

    たとえば、アプリケーション開発者は、道路や川の表を作成し、アプリケーション・ロジックを実装することで、エンド・ユーザーが空間問合せ条件に基づいて道路や川を検索できるようにします。

  • エンド・ユーザーは、KVP、POSTまたはSOAPプロトコルを使用したHTTPリクエストを介してサービスにアクセスします。

    たとえば、エンド・ユーザーは、特定の川から1マイル以内にあるすべての道路、またはその川を横断するすべての道路などの検索を行います。

管理者の立場から見ると、アプリケーション開発者もエンド・ユーザーもすべてユーザーです。これは、それぞれのニーズに合わせてデータベース・ユーザーを作成する必要があるためです。アプリケーション開発者は、空間表を作成および管理し、Oracle Spatial and Graphのファンクションおよびプロシージャを使用するための十分な権限を持つユーザーとして、データベースに接続します。エンド・ユーザーは、HTTPリクエストを介してデータベースにアクセスします。

Spatial and GraphのWebサービスに関する章は、エンド・ユーザー向けではなく、管理者およびアプリケーション開発者を対象としています。

親トピック: 空間Webサービスの概要

11.3 空間Webサービスのデプロイと構成

このトピックでは、空間Webサービス、特にWFS、WCSおよびCSWのデプロイおよび構成で行う処理について説明します。

これらのサービスはJava Webアプリケーションとして実装され、WebLogic 12.1.3以上にデプロイして実行できます。必要なJavaバージョンはJDK 1.8以降です。

  • WFS、CSWおよびCSWは、sdows.earファイルにパッケージされています。

  • ジオコーダ・サービスは、geocoder.ear.zipファイルにパッケージされています。

  • ルーティング・エンジンは、routeserver.ear.zipファイルにパッケージされています。

このトピック内の一般的な手順に加えて、使用する各空間Webサービスに関する章を参照し、その他のデプロイおよび構成のタスクを確認してください。

Oracle Spatial and Graph Webサービスのデプロイに伴う主なタスクは次のとおりです。

  1. WebLogic Server(バージョン12.1.3以上)の準備

  2. WebLogic Serverでのドメインの作成

  3. WebLogic Serverでのサーバー起動引数の構成

  4. WebLogic Serverでの空間Webサービスのデプロイ

  5. WebサービスWebアプリケーションがアクティブな状態であることの確認

  6. 各空間Webサービスの構成

WebLogic Server(バージョン12.1.3以上)の準備

Webサービス・エンジンをデプロイする前に、WebLogic Serverで管理対象サーバーを作成することをお薦めします。

Webサービス・エンジンを管理対象サーバーに正常にデプロイするには、WebLogicドメインが作成されている必要があります。

WebLogic Serverでのドメインの作成

WebサービスのドメインがWebLogic Serverに存在することを確認する必要があります。空間ドメインを作成するには、次のステップに従います。

  1. WebLogic Serverコンソールにログインします。

  2. 「新しいWebLogicドメインの作成」を選択し、「次へ」をクリックします。

  3. 「ドメイン・ソース: 自動的に構成されたドメインの生成」を選択し、「次」をクリックします。

  4. 管理者のユーザー名とパスワードを構成し、「次」をクリックします。

  5. サーバーの起動モードに「開発」または「本番」を選択します。

  6. 「JDK」に、使用可能なJDKのいずれかを選択します。

  7. 環境のカスタマイズとサービスの設定で、デフォルト値を受け入れるか、カスタマイズを指定します。

  8. WebLogicドメインの作成ページで「作成」、「次」の順にクリックします。

  9. ドメインの作成中画面で、「完了」をクリックします。

ドメインの作成および構成の詳細は、WebLogic Serverのドキュメントを参照してください。

WebLogic Serverでのサーバー起動引数の構成

空間WebサービスWebアプリケーションには、構成ファイルおよびログ・ファイルの保存用フォルダが必要です。このフォルダは、sdowsという名前のJava引数としてWebLogic Serverに渡されます。ノード・マネージャを実行している場合は、次のステップに従ってWebLogic Server管理コンソールを使用してこの引数を構成します。

  1. WLSコンソールにログインします

  2. 「環境」 - 「サーバー」で「管理対象サーバー」を選択します。

  3. 「構成」タブで、「サーバーの起動」を選択します。

  4. -Dsdows=<configuration folder path>を「引数」に追加します(<configuration folder path>は、構成ファイルおよびログ・ファイルが格納される書込み可能フォルダへのパスです)。

ノード・マネージャを実行していない場合は、スクリプト<WLS domain>\bin\setDomainEnvを編集します。set JAVA_PROPERTIESを検索し、次を行末に追加します。 

 -Dsdows=<configuration folder path>

WebLogic Serverでの空間Webサービスのデプロイ

空間WebサービスをWebLogic Serverにデプロイするには、次のステップに従います。

  1. WLSコンソールにログインします

  2. 「デプロイメント」、「インストール」の順にクリックします。

  3. sdows.ear (ファイル)を選択して、「次」をクリックします。

  4. 「このデプロイメントをアプリケーションとしてインストールする」ターゲット・スタイルを選択し、「次へ」をクリックします。

  5. WFSエンジンのデプロイ先となるサーバー候補の一覧で、作成した管理対象サーバーの名前を選択し、「デプロイメントを次の場所からアクセス可能にする」を選択して「次」をクリックします。

  6. デプロイメント名がsdowsであることを確認し、「終了」をクリックします。

WebサービスWebアプリケーションがアクティブな状態であることの確認

空間Webサービスに必要なステップを完了したら、「デプロイメント」ページでアプリケーションがActive状態であることを確認します。

Prepared状態の場合、「起動」をクリックしてアプリケーションを起動します。

各空間Webサービスの構成

次のステップは、使用する各空間Webサービス(WFS、WCSまたはCSW)をそれぞれ構成することです。ご使用の環境でサポートするWebサービスに応じて、特定のタスクを実行する必要があります。権限を作成し、データベース・ユーザーに付与する必要がある場合があります。WebLogic Serverで、特別なデータ(ジオコーディング用など)のダウンロードおよびロード、構成ファイルの変更、またはデータ・ソースの作成が必要な場合もあります。

関連する各空間Webサービスの章で、そのサービスに固有の手順を確認してください。

親トピック: 空間Webサービスの概要

11.4 空間Webサービスの管理コンソール

Oracle Spatial and Graphには、空間Webサービスの管理コンソールが用意されています。管理コンソールはいくつかのコンポーネントで構成されており、WFS、WCSおよびCSW Webサービス・エンジンを構成したり、各サービスをテストしたり、エラー・ログを表示して診断したりできます。これは、sdows.earファイル内に含まれています。

管理コンソールにアクセスするには、次の形式のURLに移動します。

http://<system-name>:<port>/oraclespatial/

「サービス」ページを使用するには、すべての使用可能なデータ・ソース名のリストからデータ・ソースを選択します。(現在選択されているデータ・ソースは右上隅に表示されますが、いつでもそこで変更できます。)

  • 「構成ファイル」タブでは、GetCapabilitiesレスポンスに示されるロギング・レベルなどのサービス・パラメータやサービス・プロバイダ情報を変更できます。

  • WFS、WCSおよびCSWの「テスト」タブでは、様々な操作の簡単なリクエストを作成できます。これを編集してパラメータを追加または変更し、HTTP POST/XMLリクエストとして送信できます。レスポンスも表示されます。

  • WFS、WCSおよびCSWの「ログ」タブでは、各サービスのログ・ファイルの内容を表示できます。各「ログ」タブではzipファイルに圧縮したログをダウンロードし、後でこの情報を使用して問題を診断することもできます。

コンソールのページとWFS、WCSおよびCSWの詳細は、それらのサービスの章を参照してください。

親トピック: 空間Webサービスの概要