ja/tools/WebRoutingService

WebRouting Service (WRS)

[English]

謝辞：この日本語訳は、日本ユニシス株式会社様から提供されたものです。

概要

WebRoutingサービスは、HTTPプロトコルを通して容易に経路探索機能を使用するように設計されたWebサービスです。WebRoutingサービスは"リソース指向アーキテクチャ"(Leonard Richardson & Sam Ruby著 RESTful Web Service 参照)であるREST(Representational State Transfer)に基づいています。WebRoutingサービスはJava言語で開発され、JavaクラスをRESTコンセプトにマッピングしたフレームワークであるRestletフレームワークを使用しています。

手軽に使用されるように、WebRoutingサービスは多くの空間データフォーマットに対応しています。(Geojson, GML, KML,...)

インストール (バージョン 1.0)

SVNリポジトリからプロジェクトをチェックアウトしてください: 

svn checkout http://pgrouting.postlbs.org/svn/pgrouting/branches/routingservice wrs

必要条件:

 * pgRounting 1.0
 * Java Runtime Environment (JRE) 1.5 or higher

Java技術により、WebRoutingサービスはJava実行環境のあるオペレーティング・システム(OS)にインストールすることができます。現在のところ、私たちはLinux環境でのみWebRoutingサービスをテストしています。クライアント側にはPOSTとGETリクエストをサーバに送信できるアプリケーションのみが必要です。

WebRouting サービスのダウンロード:

WebRoutingサービスの最新リリースをダウンロードしてください。ダウンロード完了後、WebRoutingサービスをインストールしたいディレクトリにtarファイルを解凍してください。

設定:

WebRoutingサービスを開始する前に、サーバの設定が必要です。そのため、WebRoutingサービスディレクトリの直下にある"configuration.xml"ファイルを編集してください。

Linux上での起動方法:

以上でWebRoutingサービスの起動準備は終了です。あとはシンプルなシェル・スクリプト:"start.sh"を呼び出します。エラーがなければ、インストールは完了し、WebRoutingサービスは開始されています。エラーの場合、二つの可能性が考えられます:

  • XML設定ファイルに誤りがあります。この場合は"設定"ステップに戻ってください。
  • JREが正しくインストールされていないか、JAVA_HOME環境変数が正しく定義されていません。 
./start.sh

使用方法

インストールに問題がない場合は、早速リクエストを生成できますが、その前にWebRoutingサービス機能を見てみましょう。
WebRoutingサービスを呼び出すためには、2つの方法:GETリクエストとPOSTリクエストがあります。

両方とも、プロバイダー、サービス、入出力データ形式を指定したURLを与えなければなりません。URLの形式は次のようになります: 

http://ip_address:port_number/provider_name/format_for_input_data/service_name.format_for_output_data

例: 

http://178.1.1.10:8182/geobase/geojson/shortest_path.kml

この例では、geobaseプロバイダーのgeojason形式の入力データを用いてWebRoutingサービスを呼び出し、最短経路サービスの結果をKML形式で返すよう要求します。このように、URLには"何を持っているか"と"何が欲しいか"を指定します。 次のステップは:指定されたサービスで使用されるパラメータの値を与えることです。一つのサービスに利用されるすべてのパラメータは、XML設定ファイルに指定されています。また、1つのパラメータが必須あるいはオプショナルであるかどうかも指定することができます。このステップは、GETまたはPOSTリクエストで行います。

リクエストを生成する準備ができました。"tests"リポジトリ内の"test.html"ファイルを開いてください。このシンプルなページはWebRoutingサービスをテストするための簡単な方法を提供します。フォームを埋めるだけで、GET/POSTリクエストが自動的に生成されます。リクエストの結果は、Webページの下部に表示されます。

動かない場合は、"インストール"ステップに戻ってください。

ビルド方法

近日公開 :)

この日本語訳の著作権は、日本ユニシス株式会社に帰属しています。また、この日本語訳は、GNU FDLのもとで提供されています。