データマッピングのためのRESTful Webサービス

MapForce 2016 リリース2では、以下の機能が拡張されていますウェブサービスのデータマッピング, REST Webサービスに対して、強力なサポートを提供します。MapForceは、Webサービスの応答としてXMLまたはJSONを受け付け、パラメータの定義を可能にし、カスタムHTTPヘッダーにも対応しています。ユーザーは、Webサービスインターフェースを手動で定義することも、WADLファイルやURLから設定をインポートすることもできます。REST Webサービスのパラメータを手動で定義する場合、開発者はテンプレートURLに基づいて設定を作成できます。これは、開発者がWebブラウザ上でREST呼び出しをテストおよび調整する際に便利です。なぜなら、URLをブラウザからコピーしてテンプレートとして利用できるからです。

GPSシステムによって取得される座標は、以前にも述べたように正確ですが、しかし標高データは、非常に精度が低いことで知られています. 米国地質調査局（USGS）は、経度と緯度に基づいて高度データを正確に提供するREST Webサービスを提供しています。このサービスは、XML形式またはJSON形式でデータを提供します。このWebサービスをMapForceのデータマッピング機能で使用することで、Garminデバイスから取得したGPSデータを更新し、同時にデータ形式をXMLからJSONに変換することができます。

まず、ウェブサービスをブラウザ上でテストします。以下に示されたURLにアクセスすると、サンプルクエリを生成するための入力フォームが表示されます

「標高を取得」ボタンをクリックすると、システムは完全なREST GETリクエストを生成し、それを送信して、その結果を画面下部に表示します。この結果を利用して、データマッピングにおけるレスポンスのモデルを作成することができます。

マップフォースのツールバーにある「Webサービス機能の挿入」ボタンをクリックすると、Webサービスがマップに追加されます。これにより、「Webサービス呼び出し設定」ダイアログが開かれ、そこに米国地質調査局（USGS）のサービスURLを入力します。

次に、リクエストパラメータとレスポンスボディを定義する必要があります。これらが、後述する「呼び出し設定」ダイアログの次の部分で示すように、マッピングに使用する要素を構成します。

ブラウザのウィンドウに保存されたJSONデータに基づいて、XMLSpyでJSONスキーマを簡単に生成し、レスポンスの定義を行いました。以下に、変換されたレスポンスのXMLSpyにおけるスキーマの表示を示します

USGSの標高データ入力フォームには、入力パラメータを定義するために必要なすべての情報が記載されているため、これらの情報を次のセクションである「コール設定」ダイアログに追加することができます

各リクエストにおける単位と出力値は、実行中に変更されません。固定値を設定することも可能でしたが、代わりに、これらの値をマッピング内で定数として提供します。必要なセキュリティ設定は、コール設定ダイアログで構成してください。ダイアログを閉じるために「OK」をクリックすると、Webサービス関数がマッピングに追加されます。

ソースのGPXファイルに含まれる各トラッキングポイントは、一連の座標データを提供します。マッピング処理の実行中、各トラッキングポイントが処理されるたびに、Webサービス経由でUSGSにGETリクエストが送信され、その応答として、標高データを置き換えるための情報が提供されます。

次に、リクエストとレスポンスの要素を、以下に示すように、入力と出力のコンポーネントに接続するだけです。左上には、単位と出力タイプの定数が表示されており、出力に挿入する前に、標高値は小数点以下2桁に丸められます。

注意点として、出力はJSONファイルです。このマッピングの抜粋表示では、入力コンポーネントは表示されていませんが、実際には標準的なGPXファイルで、XML形式で構成されています。図示されているWebサービス機能の背面に配置され、出力コンポーネントに接続されているデータマッピングの接続線は、すべてXML形式の入力データから、変更なしにコピーされる値です。これらの値は、対応するJSON要素に格納されます。

「MapForce 出力」ボタンをクリックすると、データ変換処理が実行され、JSONファイルが生成されます。以下に、その一部の表示例を示します

本番環境では、作成したマッピングをMapForce実行ファイルとして保存し、MapForceサーバーによって自動的に処理することができます。この処理は、コマンドラインから実行することも、FlowForceサーバーの制御下で実行することも可能です。

Altova MapForceは、受賞歴のあるグラフィカルなデータマッピング、変換、統合ツールであり、XML、データベース、EDI、XBRL、テキストファイル、Excel、JSON、および/またはWebサービスなど、あらゆる種類のデータ形式間のマッピングを可能にします。フル機能の無料トライアル版をダウンロードして、ぜひご自身で試してみてください！