====== GPX + kashmir3d extensions ======
カシミール3Dが入出力するGPXファイルは、[[https://www.topografix.com/gpx.asp|GPX: the GPS Exchange Format]]のextensions要素にカシミール3Dの独自要素（名前空間kashmir3d）を格納したもの。
===== kashmir3d extensions =====
独自要素はhttp://www.kashmir3d.com/namespace/kashmir3d.xsdで次表のものが定義されている。GPX2GeoJSONは、このうちのicon、line_color、line_size、line_styleの4項目を参照する。
^  name           ^  type    ^  備考              ^
| ident           | string   | GPSでの名前          |
| **icon**        | decimal  | アイコン番号           |
| dir             | decimal  |                  |
| tilt            | decimal  |                  |
| depth           | decimal  |                  |
| proximity       | decimal  |                  |
| section         | decimal  | ルートの区切り          |
| aux1            | decimal  |                  |
| aux2            | decimal  |                  |
| lap_time        | decimal  |                  |
| lap_dist        | decimal  |                  |
| lap_cal         | decimal  |                  |
| **line_color**  | string   | 表示色（16進数bbggrr）  |
| **line_size**   | decimal  | 線幅（ピクセル単位）       |
| **line_style**  | decimal  | 線種               |
===== ウェイポイント／ルートポイントのプロパティ =====
カシミール3Dの「ウェイポイント／ルートポイントのプロパティ」設定画面（下図）で設定した項目は、GPXファイルの次の要素に格納される（GPX2GeoJSONで参照しているもの＋αのみ）。
^  設定項目  ^  GPX要素  ^  備考  ^
| 名前  | name  | |
| GPSでの名前  | kashmir3d:ident  | |
| アイコン  | kashmir3d:icon  | アイコン番号 |
| GPSでの備考  | cmt  | |

{{ :gps-track-maps:spatial-data:wptprop.png?nolink |ウェイポイント／ルートポイントのプロパティ}}

==== アイコン ====
アイコン番号とアイコン画像の対応を[[https://map.jpn.org/iconlut.xml|アイコン変換表]]に示す。また、アイコン番号に対応する画像ファイルを次のURLで公開する。
<code>
https://map.jpn.org/icon/アイコン番号.png
</code>
これらのアイコン変換表とアイコン画像は、[[https://anineco.nyanta.jp/gpx2jsgi/gpx2jsgi.html|GPX2JSGI（GPX→KMLコンバータ）]]に同梱したiconviewユーティリティによって作成できる。
==== 名前／GPSでの備考 ====
名前（name要素）は、ルート地図表示の際のウェイポイントとルートポイントのポップアップ表示のタイトルやラベル表示に用いられる。GPSでの備考（cmt要素）はポップアップ表示の本文に用いられ、「項目=値」の形式を','で区切って入力する。
===== トラック／ルートのプロパティ =====
カシミール3Dの「トラックデータプロパティ」（下図）や「ルートデータプロパティ」設定画面で設定した項目は、GPXファイルの次の要素に格納される（GPX2GeoJSONで参照しているもの＋αのみ）。
^  設定項目  ^  GPX要素                ^  備考  ^
| タイトル   | name                  |      |
| 表示色    | kashmir3d:line_color  |      |
| 線幅     | kashmir3d:line_size   |      |
| 線種     | kashmir3d:line_style  |      |
| アイコン   | kashmir3d:icon        | ※1   |
※1：トラックのアイコンは、ルート地図では表示しない。

{{ :gps-track-maps:spatial-data:trkprop.png?nolink |}}


==== line_size：線幅 ====
カシミール3Dの「トラックデータプロパティ」や「ルートデータプロパティ」の設定画面において指定した線幅（単位：ピクセル）が格納される。
==== line_style：線種 ====
カシミール3Dの「トラックデータプロパティ」や「ルートデータプロパティ」の設定画面において指定した線種のコードが格納される。線種と、GPX2GeoJSONで用いているline gap patternを次表に示す。
^  line_style  ^  線種                   |^  line gap pattern  ^
|  1           | 実線     | solid         |                |
|  11          | 破線（短）  | short dash    | [4,2]          |
|  12          | 破線（長）  | long dash     | [6,2]          |
|  13          | 点線     | dot           | [1,2]          |
|  14          | 1点鎖線   | dot-dash      | [1,2,5,2]      |
|  15          | 2点鎖線   | dot-dot-dash  | [1,2,1,2,6,2]  |
|  21          | 二重線    | double        |                |

===== その他の要素 =====
===== GPXファイルの例 =====
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<gpx creator="Kashmir3D 9.310 - http://www.kashmir3d.com" version="1.1"
  xmlns="http://www.topografix.com/GPX/1/1"
  xmlns:kashmir3d="http://www.kashmir3d.com/namespace/kashmir3d">
  <rte>
    <extensions>
      <kashmir3d:line_color>000080</kashmir3d:line_color>
      <kashmir3d:line_size>2</kashmir3d:line_size>
      <kashmir3d:line_style>15</kashmir3d:line_style>
    </extensions>
    <name>蓼科山</name>
    <number>1</number>
    <rtept lat="36.085073" lon="138.280723">
      <ele>1741.570000</ele>
      <extensions>
        <kashmir3d:icon>903001</kashmir3d:icon>
      </extensions>
      <name>No. 2196</name>
      <time>2018-07-01T20:21:56Z</time>
    </rtept>
      :
  </rte>
  <trk>
    <extensions>
      <kashmir3d:icon>901001</kashmir3d:icon>
      <kashmir3d:line_color>0000ff</kashmir3d:line_color>
      <kashmir3d:line_size>2</kashmir3d:line_size>
      <kashmir3d:line_style>12</kashmir3d:line_style>
    </extensions>
    <name>蓼科山～北横岳</name>
    <number>1</number>
    <trkseg>
      <trkpt lat="36.107320000" lon="138.298471000">
        <ele>2369.790000</ele>
        <time>2018-06-30T23:21:32Z</time>
      </trkpt>
        :
    </trkseg>
  </trk>
  <wpt lat="36.083228" lon="138.291831">
    <cmt>駐車=5台</cmt>
    <ele>1657.930000</ele>
    <extensions>
      <kashmir3d:icon>954025</kashmir3d:icon>
    </extensions>
    <name>竜源橋登山口</name>
    <sym>Parking Area</sym>
    <time>2018-07-01T08:09:02Z</time>
  </wpt>
    :
</gpx>
</code>