mirror of
https://github.com/tumic0/GPXSee.git
synced 2024-11-27 21:24:47 +01:00
226 lines
9.6 KiB
HTML
226 lines
9.6 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<title>GPXSee - Documentation</title>
|
|
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
|
|
<link rel="icon" type="image/png" href="css/images/favicon.png"/>
|
|
<link rel="stylesheet" href="css/style.css" type="text/css" media="all" />
|
|
<!--[if IE 6]><link rel="stylesheet" href="css/ie6.css" type="text/css" media="all" /><![endif]-->
|
|
<!-- Global site tag (gtag.js) - Google Analytics -->
|
|
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-110140219-1"></script>
|
|
<script>
|
|
window.dataLayer = window.dataLayer || [];
|
|
function gtag(){dataLayer.push(arguments);}
|
|
gtag('js', new Date());
|
|
|
|
gtag('config', 'UA-110140219-1');
|
|
</script>
|
|
</head>
|
|
<body>
|
|
<!-- START PAGE SOURCE -->
|
|
<div class="shell">
|
|
<div class="shell-b">
|
|
<div id="header">
|
|
<img src="css/images/gpxsee.png" alt="" class="logo"/><h1 class="logo"><a href="http://www.gpxsee.org">GPXSee</a></h1>
|
|
<div id="navigation">
|
|
<ul>
|
|
<li><a href="index.html">Home</a></li>
|
|
<li><a href="gallery.html">Screenshots</a></li>
|
|
<li><a href="doc.html" class="active">Documentation</a></li>
|
|
<li><a href="index.html#download">Download</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="cl"> </div>
|
|
</div>
|
|
<div id="main">
|
|
<div id="content">
|
|
|
|
<h2 id="data">Data files</h2>
|
|
<p>GPXSee opens GPX, TCX, FIT, KML, IGC, NMEA and
|
|
<a href="http://www.poi-factory.com/garmin-csv-file-format">Garmin CSV</a>
|
|
files, however not all format features are supported for all formats.
|
|
Generally, GPXSee supports three kinds of data objects:</p>
|
|
|
|
<ul>
|
|
<li>Tracks</li>
|
|
<li>Routes</li>
|
|
<li>Waypoints</li>
|
|
</ul>
|
|
|
|
<p>Naturally, if a format supports only a subset of the objects, GPXSee also
|
|
supports only this subset. Some formats - especially KML - have support for
|
|
a plenty of other data objects like surfaces or even 3D structures. Those are
|
|
not supported by GPXSee.</p>
|
|
|
|
<p>In addition to GPS data, data from the following sensors is supported
|
|
by GPXSee:</p>
|
|
|
|
<ul>
|
|
<li>Heart rate</li>
|
|
<li>Cadence</li>
|
|
<li>Power</li>
|
|
<li>Temperature</li>
|
|
</ul>
|
|
|
|
|
|
<h2 id="maps">Maps</h2>
|
|
<p>Two kinds of maps are supported by GPXSee - online maps and offline maps.
|
|
You may either load them "ad hoc" from the GUI or they can be loaded
|
|
automatically at program startup from the following directory:</p>
|
|
|
|
<table class="config-files">
|
|
<tr>
|
|
<td class="os">Windows:</td>
|
|
<td class="file">C:\Program Files\GPXSee\maps</td>
|
|
</tr><tr>
|
|
<td class="os">Linux:</td>
|
|
<td class="file">/usr/share/gpxsee/maps</td>
|
|
</tr><tr>
|
|
<td class="os">OS X:</td>
|
|
<td class="file">/Applications/GPXSee.app/Contents/Resources/maps</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>User specific map directories that - when present - override the global map
|
|
directory are also supported. The paths are as follows:</p>
|
|
|
|
<table class="config-files">
|
|
<tr>
|
|
<td class="os">Windows:</td>
|
|
<td class="file">%HOMEPATH%\GPXSee\maps</td>
|
|
</tr><tr>
|
|
<td class="os">OS X, Linux:</td>
|
|
<td class="file">$HOME/.gpxsee/maps</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>The map directory is recursively searched when loading the maps, so it
|
|
may contain an arbitrary directory structure.</p>
|
|
|
|
<h3 id="online">Online maps</h3>
|
|
<h4 id="TS">OSM/Google tiles</h4>
|
|
<p>GPXSee supports most tile server based online maps out there, but the
|
|
<a href="https://github.com/tumic0/GPXSee/tree/master/pkg/maps">list
|
|
of maps</a> distributed with the official packages is limited to those
|
|
that are "freely distributable". You may however easily extend (or change)
|
|
the default map list with your own map sources definitions.</p>
|
|
|
|
<p>The mapsource definition file format is based on XML and is fairly simple.
|
|
The root <i>map</i> element contains two mandatory elements - <i>name</i>
|
|
and <i>url</i>, and two optional elements - <i>zoom</i> and <i>bounds</i>.
|
|
The tile X and Y coordinates are replaced with <code>$x</code> and
|
|
<code>$y</code> in the URL and the zoom level is replaced with
|
|
<code>$z</code>. An example map source definition file could look like:</p>
|
|
|
|
<pre>
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<map>
|
|
<name>Czech Republic</name>
|
|
<url>http://tile.server.cz/map/$z/$x/$y.png</url>
|
|
<zoom min="2" max="15"/>
|
|
<bounds left="12.3" bottom="48.6" right="18.9" top="51.2"/>
|
|
</map>
|
|
</pre>
|
|
|
|
<p>The bounds are WGS84 latitude/longitude values in degrees. If omitted, the
|
|
default zoom range is <0, 19> and the default bounds are
|
|
<-85.0511, 85.0511> and <-180, 180>.</p>
|
|
|
|
<h4 id="WMTS">WMTS</h4>
|
|
<p>WMTS maps are distinguished by setting the <i>type</i> attribute of the
|
|
<i>map</i> element to <code>WMTS</code>. Both the KVP and REST access methods
|
|
are supported.</p>
|
|
|
|
<p>For KVP, the <i>url</i> element represents the WMTS base URL and three
|
|
additional elements are required - <i>layer</i>, <i>style</i> and <i>set</i>
|
|
(TileMatrixSet in WMTS). An optional <i>format</i> element may be specified
|
|
defining the desired image format. If not set, <code>image/png</code> is
|
|
used.</p>
|
|
|
|
<pre>
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<map type="WMTS">
|
|
<name>CUZK</name>
|
|
<url>http://geoportal.cuzk.cz/WMTS_ZM_900913/WMTService.aspx</url>
|
|
<format>image/png</format>
|
|
<layer>zm</layer>
|
|
<style>default</style>
|
|
<set axis="yx">ogc:1.0:globalcrs84pixel</set>
|
|
</map>
|
|
</pre>
|
|
|
|
<p>For REST access, the <i>url</i> element's <i>type</i> attribute must be set
|
|
to <code>REST</code>. The URL then represents the URL of the capabilities XML
|
|
document. The three mandatory elements - <i>layer</i>, <i>style</i> and
|
|
<i>set</i> - must be present like in the KVP case. Defining the format has no
|
|
relevance for the REST access method.</p>
|
|
|
|
<pre>
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<map type="WMTS">
|
|
<name>Wien - Ortho</name>
|
|
<url type="REST">http://maps1.wien.gv.at/wmts/1.0.0/WMTSCapabilities.xml</url>
|
|
<layer>lb</layer>
|
|
<style>farbe</style>
|
|
<set>google3857</set>
|
|
</map>
|
|
</pre>
|
|
<p>There is one more important attribute - the <i>axis</i> attribute of the
|
|
<i>set</i> element. It specifies the axis order for the CRS used for the
|
|
tile matrix set. Technically the order should be obtainable from the CRS definition,
|
|
but in praxis many servers use the wrong order. This is why GPXSee uses <b>x,y
|
|
(lon,lat) as default</b> and if the set uses the reverse order, the <i>axis</i>
|
|
attribute must be set to <code>yx</code> in the map definition.</p>
|
|
|
|
<p>For the formal mapsource file syntax see the
|
|
<a href="map/1/map.xsd">mapsource XSD file</a>.</p>
|
|
|
|
<h3 id="offline">Offline maps</h3>
|
|
<p>OziExplorer maps, TrekBuddy maps/atlases and GeoTIFF images are supported by
|
|
GPXSee. Supported map projections are Web Mercator, Transverse Mercator (including UTM),
|
|
Lambert Conformal Conic, Albers Equal Area, Lambert Azimuthal Equal Area and
|
|
Latitude/Longitude (2D geographic). For list of supported datums and PCSs see
|
|
the <a href="https://github.com/tumic0/GPXSee/blob/master/pkg/csv/ellipsoids.csv">ellipsoids.csv</a>,
|
|
<a href="https://github.com/tumic0/GPXSee/blob/master/pkg/csv/gcs.csv">GCS.csv</a>
|
|
and <a href="https://github.com/tumic0/GPXSee/blob/master/pkg/csv/pcs.csv">PCS.csv</a>
|
|
configuration files (can be modified or overridden by user files like the map
|
|
directory).</p>
|
|
|
|
<p>You may easily create offline atlases from online map services by using
|
|
<a href="http://mobac.sourceforge.net/">Mobile Atlas Creator (MOBAC)</a>.</p>
|
|
|
|
|
|
<h2 id="poi">POI files</h2>
|
|
<p>All of the supported formats with waypoints capability - GPX, KML, TCX, NMEA
|
|
and Garmin CSV - can be loaded either as data files or as POI files. When a file
|
|
is opened as a POI file, only waypoints reasonable near the tracks/waypoints of
|
|
the loaded data files are displayed.</p>
|
|
|
|
<p>To make GPXSee load a POI file automatically on startup, add the file to the
|
|
<code>POI</code> directory in one of the configuration paths.</p>
|
|
|
|
</div>
|
|
|
|
<div id="sidebar">
|
|
<h4><a href="#data">Data files</a></h4>
|
|
<h4><a href="#maps">Maps</a></h4>
|
|
<h5><a href="#online">Online maps</a></h5>
|
|
<h5><a href="#offline">Offline maps</a></h5>
|
|
<h4><a href="#poi">POI files</a></h4>
|
|
</div>
|
|
<div class="cl"> </div>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="footer">
|
|
<div class="shell">
|
|
<p class="lf">Copyright © 2017 Martin Tůma - All Rights Reserved</p>
|
|
<p class="rf">Design by <a href="http://www.websitecsstemplates.com/" target="_blank">WebsiteCSSTemplates</a></p>
|
|
<div style="clear:both;"></div>
|
|
</div>
|
|
</div>
|
|
<!-- END PAGE SOURCE -->
|
|
</body>
|
|
</html>
|