サンプルのGPXデータと、それを変換して得られたファイル。マニュアル用画像ファイル。マニュアル用JavaScript。バージョンアップGPX2JSGIのバージョンアップは、旧バージョンのアプリフォルダをまるごと削除して、新バージョンのアプリフォルダで置き換えます。Ver.1.2以前のGPX2JSGIでシンボル画像をカスタマイズしていた場合は、アプリフォルダを削除する前に中のiconlut.xmlのバックアップを作成し、GPX2JSGIのデータフォルダにコピーします。データフォルダの場所については、データフォルダの項を参照して下さい。アンインストールGPX2JSGIのアンインストールは、GPX2JSGIのアプリフォルダをまるごと削除して下さい。GPX2JSGIのデータフォルダも、不要であれば削除して差し支えありません。起動GPX2JSGIのアプリフォルダ内のgpx2jsgi.exe(青い羽根のアイコン)をクリックすると、GUIが起動して図1のような窓が開きます。ActiveTclがインストール済ならば、gpx2jsgi.tclをクリックしても全く同じ窓が開きます。両者は、Tcl/Tkのインタプリタが内蔵か、外部かが異なるだけで、機能・動作は全く同じです。変換したいGPXファイル(1個以上)を、右側の『←追加』ボタンを押してファイル選択ダイアログを開き、「GPXファイル」のリストに追加します。ファイル選択ダイアログでは、ControlキーやShiftキーを押しながらクリックすることにより、複数ファイルを同時に選択することができます。リスト中のファイルをマウスで選択して『除外』ボタンを押すと、リストから取り除くことが出来ます。『クリア』ボタンを押すと、リストは空になります。次に、「出力形式」をJSGI、KML、GPXの中から選択し(起動時はKMLが選択されています)、「出力ファイル」を右側の『選択』ボタンを押して指定します。拡張子を指定しなかった場合は、自動的に付加されます。通常は「メタデータを付加」欄のチェックは外したままで差し支えありません。「メタデータを付加」欄にチェックを入れると、その下の各欄が図2のように編集可能になり、設定した文字列がメタデータとして出力ファイルに書き込まれます。GPX2JSGIを初めて立ち上げたときは「提供者」以下は空欄になっているので、適宜記入して下さい。各項目の意味は、次の通りです。図2に記入例があります。データセット名:データのタイトル。作成日:データを作成した日付。YYYY-MM-DDの形式で設定します。提供者:データ作成者の名称。Email:データ作成者のEmail。URL:データ作成者のウェブサイトのURL。URLが出力ファイルに書き込まれます。記入したメタデータのうち、提供者、Email、URL、摘要は自動的に保存され、次にGPX2JSGIを起動したときに自動的に読み込まれます。トラックポイント間引き設定トラックポイントを間引く場合は、「軌跡を間引く」欄にチェックを入れて下さい。すると、その下の「許容誤差」のスピンボックスが編集可能になるので、正の数値(単位はkm)を設定します。errorアルゴリズムを用いたGPSBabelのSimplifyフィルタを利用しています。許容誤差を大きくすると間引かれる点数が増えますが、軌跡の細部の形状が失われるので、調節が必要です。最初は初期設定値(0.005km)で試してみて下さい。全ての必要項目を記入したのちに『変換』ボタンを押すと、変換結果が「出力ファイル」に指定したファイルに出力されます。変換が成功すると、図3に示すように、変換後のトラックポイント数と中心座標の計算結果(緯度、経度。単位は度)を表示します。中心座標は『コピー』ボタンを押すとクリップボードにコピーされ、他のアプリケーションにペーストすることができます。変換実行後のGUI画面KMLファイルに変換後に『KML→KMZ』ボタンを押すと、引き続いてKMZ形式に変換し、拡張子を.kmzに変えたファイル名で出力します。『終了』ボタンを押すと、プログラムを終了します。変換仕様ウェイポイントカシミール3Dの「ウェイポイント/ルートポイントのプロパティ」(図4)の設定項目が、地理院地図でどのように表示されるかを説明します。ウェイポイント/ルートポイントのプロパティアイコン:カシミール3Dで指定したアイコンは、GPX形式の中では「コード番号」で記録されます。iconlut.xml)を参照して、コード番号を対応するシンボル画像のURLに変換します。初期設定では、http://map.jpn.org/(GPX2JSGIの配布サイトの別名です)に設置済のシンボル画像のセットにアクセスします。この画像セットは、カシミール3Dのアイコンの全てに対応しています。アイコン変換表の詳細と、シンボル画像のカスタマイズの方法については、技術情報を参照して下さい。名前、GPSでの備考:地理院地図において、シンボル(点型データ)にマウスポインタを重ねると、ポップアップ窓で表示されます。GPSでの備考にはシンボルの属性情報を「項目名1=値1,項目名2=値2,...」のように項目名と値を「=」(イコール)で接続し、カンマ区切りで列挙して記述します。項目名の先頭に「@」(アットマーク)を付けると、その項目は表示されません。項目名を「URL」とすると、値はURLと解釈されてハイパーリンクが張られます。ルートカシミール3Dの「ルートデータプロパティ」(図5)の設定項目が、地理院地図でどのように表示されるかを説明します。ルートデータプロパティ表示色:カシミール3Dで指定した色は、透過率50%で表示されます。線幅:カシミール3Dで指定した幅(1〜9)を地図上の幅(単位はピクセル)として表示します。地図の縮尺を変えても線幅は変化しません。線種:カシミール3Dで指定した種類に関わらず実線で表示されます。カシミール3Dでは、ルート上の各ポイントに対しても図4の「ウェイポイントのプロパティ」を開いて、全く同様のプロパティを設定することができます。Ver.1.2より、ルートポイントもウェイポイントと同様にJSGI形式に変換するように、仕様が変更されました。アイコンが「地名」グループの「なし」(コード番号903001)のルートポイントは例外で、変換されません(「なし」アイコンのウェイポイントは変換されます)。ルートポイントを変換したくない場合は、アイコンを「なし」に設定して下さい。複数のルートポイントを選択してから「ウェイポイントのプロパティ」を開くと、アイコンの一括変更が可能です。トラックカシミール3Dの「トラックデータプロパティ」(図6)の設定項目が、地理院地図でどのように表示されるかを説明します。:ルートの場合と同様です。アイコン:トラックデータに指定したアイコンは変換対象外です。パスとするフォルダに置きます。このフォルダを、GPX2JSGIのデータフォルダと呼びます。Dataフォルダを指す環境変数で、OSによって次のように定められています。Dataフォルダは隠しフォルダになっているので、通常はエクスプローラに表示されませんが、アドレスバーに%APPDATA%と入力すると開くことができます。アイコン変換表アイコン変換表は、カシミール3Dのアイコンのコード番号と、シンボル画像のURLの対応を定義します。GPX2JSGIが変換を実行する際には、データフォルダのiconlut.xmlがアイコン変換表として参照されます。GPX2JSGIを起動した際にこのファイルがない場合は、アプリフォルダから自動的にコピーされます。アイコン変換表を編集することにより、シンボル画像を自由にカスタマイズすることができます。下記は、アイコン変換表のファイル形式を説明するために、iconlut.xmlの冒頭の数行を抜粋したものです。丸数字は説明のために付したもので、実際のファイルには書かれていません。size="24"&gt;ピン&lt;/icon&gt;&nbsp;2&nbsp;:行1は、baseurlという名前(実体名)の内容が、文字列http://map.jpn.org/icons/を示すことを宣言しています。行2は、コード番号901001に対応するシンボル画像のURLとサイズ(24x24画素)を定義しています。シンボル画像の位置の基準は画像の中央で固定です。&baseurl;を実体参照と言い、行1の宣言により実体名の内容に置き換えられるので、このコード番号に対応するシンボル画像のURLはhttp://map.jpn.org/icons/901001.pngとなります。付属ユーティリティICONVIEWICONVIEWは、カシミール3Dでウェイポイントに設定可能なアイコンをシンボル画像(透過処理済PNG形式)に一括変換し、それ用のアイコン変換表を作成するユーティリティです。動作には、カシミール3Dがインストールされていることが必要です。アプリフォルダの中のiconview.exe(青い羽根のアイコン)をクリックしてGUIを起動し、『画像作成』ボタンを押します。作成完了のメッセージを確認してから、引き続いて『一覧表示』ボタンを押します。ブラウザが起動し、作成したシンボル画像の一覧を表示します。『終了』ボタンでICONVIEWを終了します。ICONVIEWを実行すると、シンボル画像セットがデータフォルダ内のiconsというフォルダに、アイコン変換表がデータフォルダのiconlut_local.xmlというファイルにそれぞれ出力されます。!注意!カシミール3Dに付随するデータの著作権は、作者のDAN杉本氏に属するものとされています(カシミール3Dマニュアルの24.著作権の章を参照)。Earth等を用いて表示されるルート地図の上への表示、および、それらに関連する凡例や説明のための表示に限って、かつ非商用で使用し、その他の用途や商用での使用、特に画像ファイルを単体で配布することはご遠慮下さい。JSGI2KMLJSGI2KMLは、JSGI形式のファイルをKML形式に一括変換するユーティリティです。アプリフォルダの中のjsgi2kml.exe(青い羽根のアイコン)をクリックすると、GUIが起動して窓が開きます。『←フォルダ』ボタンと『←ファイル』ボタンで変換元のJSGIファイル(拡張子xml)を選択します。『←フォルダ』でフォルダを選択すると、その下のフォルダ階層を再帰的に探索してJSGIファイルをリストアップします。『←ファイル』ボタンは、GPX2JSGIの『←追加」と同じ機能で、ファイル単位で選択します。リストにはいったファイルは『除外』と『クリア』でリストから取り除くことができます。『変換』ボタンは、リストの全ファイルに対してJSGI形式からKML形式への変換を開始します。変換結果の出力先は変換元と同じフォルダ内で、変換元のファイル名の拡張子をxmlからkmlに変えたものとなります。変換先に既に同名のファイルがある場合には、リスト上でファイル名の背景が赤になっていますので、『変換』ボタンを押す前に良く確認し、変換で上書きしたく場合はリストから除外して下さい。ログファイルを見るか、確認を求めるダイアログが開きます。ログファイルを確認する場合はNotepadが開きますので、必要に応じてログファイルを別名で保存する等の処理を行った後、Notepadを閉じて下さい。ネットワークドライブに対してファイルの再帰的探索ができないことと、ログファイルに記録された変換開始と終了時刻が1時間ずれているという不具合が確認されています。謝辞カシミール3Dという素晴らしいソフトウェアを開発して、無償で提供頂いている作者のDAN杉本氏に感謝致します。tclkit、libxml、iconv、zlib、GPSBabel、Info-ZIP、ImageMagickという強力なオープンソフトウェアの開発者にも感謝です。本ソフトウェアが、カシミール3Dと電子国土Webシステムのさらなる活用のお役に立てば幸いです。各データ形式についての情報と、XSLT、Tck/Tkのプログラミングで大変役に立った書籍を挙げます。Format地理院地図の「技術情報」。Guide更新履歴2015-03-07JSGI2KMLの説明を追加。Ver.1.5を公開(Ver.1.4は未公開)。出力形式の初期値をKML形式に変更。参照されないことがあるバグを修正。(地理院地図対応版)を公開。GPX形式から、地理院地図が読み込めるKML形式(KMLウェブ地図プロファイル)に変換。Ver.1.3に同梱。2011-03-28GPX2JSGIの公式サイトをhttp://anineco.nyanta.jp/gpx2jsgi.htmlに移転して、全面的にリニューアル。・必要な外部プログラム全てを配布パッケージに同梱。・Tclスクリプトをtclkitを用いて実行形式にラッピング。ActiveTclのインストールも不要。・カシミール3Dのアイコンに対応するシンボル画像をhttp://map.jpn.org/に設置。・ルートポイントに設定したアイコンをシンボル画像に変換する機能を追加。・JSGI形式と同様に、アイコンをシンボル画像に変換。・KMZ形式への圧縮の際、必要なシンボル画像も含んだ自立型パッケージの作成が可能。きの許容誤差の設定にスピンボックスを設置。・iconviewが生成するシンボル画像が、電子国土プラグイン版で透過しなかった問題を修正。Ver.8.8.5に対応。