Moved to docs
This commit is contained in:
vshcherb
GitHub
parent
f0e4977794
commit
25f7a2a8b3
1 changed files with 0 additions and 157 deletions
157
GPX.md
157
GPX.md
|
|
@ -1,157 +0,0 @@
|
||||||
The OsmAnd's GPX file format conforms to the GPX 1.1 specification with additional data written as extensions. There are several sections of such data:
|
|
||||||
|
|
||||||
## Track appearance
|
|
||||||
The following parameters are used to customize the appearance of a track on the map. They are used inside the "gpx" tag and apply to all tracks contained in the gpx.
|
|
||||||
#### Parameters
|
|
||||||
* **show_arrows** [*true, false*] - show / hide arrows along the path line.
|
|
||||||
* **width** [*thin, medium, bold, 1-24*] - width of the track line on the map. The thin, medium, and bold are style depended values (should be defined as currentTrackWidth attribute).
|
|
||||||
* **color** [*#AARRGGBB, #RRGGBB*] - color of a track line on the map. Hex value.
|
|
||||||
* **split_type** [*no_split, distance, time*] - split type for a track.
|
|
||||||
* **split_interval** [*double*] - split interval for a track. Distance (meters), time (seconds).
|
|
||||||
|
|
||||||
#### Example:
|
|
||||||
```xml
|
|
||||||
<gpx version="1.1" creator="OsmAndRouterV2" xmlns="http://www.topografix.com/GPX/1/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
|
|
||||||
...
|
|
||||||
<extensions>
|
|
||||||
<show_arrows>true</show_arrows>
|
|
||||||
<color>#4e4eff</color>
|
|
||||||
<split_type>distance</split_type>
|
|
||||||
<split_interval>2000.0</split_interval>
|
|
||||||
<width>bold</width>
|
|
||||||
</extensions>
|
|
||||||
</gpx>
|
|
||||||
```
|
|
||||||
## Details of a track point (trkpt)
|
|
||||||
Written to a gpx file while recording a track.
|
|
||||||
* **speed** (meters per second)
|
|
||||||
* **heading** (0-359 degrees)
|
|
||||||
|
|
||||||
#### Example:
|
|
||||||
```xml
|
|
||||||
<trkpt lat="52.397799" lon="4.575998">
|
|
||||||
<ele>203</ele>
|
|
||||||
<time>2019-05-08T10:36:43Z</time>
|
|
||||||
<hdop>3</hdop>
|
|
||||||
<extensions>
|
|
||||||
<heading>273</heading>
|
|
||||||
<speed>5.02</speed>
|
|
||||||
</extensions>
|
|
||||||
</trkpt>
|
|
||||||
```
|
|
||||||
|
|
||||||
## Calculated route(s)
|
|
||||||
This data contains all details of a route built with **OsmAnd** (route segments, turns, road names, road types, restrictions, etc.). The route can be completely restored as if just built, even in the absence of the respective offline maps.
|
|
||||||
|
|
||||||
A gpx file may contain several routes. Each of them is contained in a specific segment under **trkseg** / **extensions**. A gpx file is saved in this form when exporting a constructed route or when saving a track that consists of several separate segments via the **Plan a route** functionality.
|
|
||||||
**Plan a route** also adds one (or several, in accordance with the number of contained separate segments / tracks) **rte** blocks to the gpx file, containing route key points (**rtept**).
|
|
||||||
#### Gpx structure:
|
|
||||||
```xml
|
|
||||||
<trk>
|
|
||||||
<trkseg>
|
|
||||||
<!-- List of segment points. The order of the points corresponds to the order and length of the route segments (<route><segment length="x" ... />). -->
|
|
||||||
<!-- The value of the "length" attribute corresponds to the number of points in this segment of the route. -->
|
|
||||||
<trkpt ... ></trkpt>
|
|
||||||
<extensions>
|
|
||||||
<!-- List of route segments -->
|
|
||||||
<route>
|
|
||||||
<segment ... />
|
|
||||||
</route>
|
|
||||||
<!-- Properties of segments included in the route. -->
|
|
||||||
<!-- This data is taken from offline maps during the initial construction of a route. -->
|
|
||||||
<types>
|
|
||||||
<type ... />
|
|
||||||
</types>
|
|
||||||
</extensions>
|
|
||||||
</trkseg>
|
|
||||||
</trk>
|
|
||||||
|
|
||||||
<!-- List of intermediate route points. If there are multiple routes, the order of the rte list matches the order of the route segments. -->
|
|
||||||
<rte>
|
|
||||||
<rtept ... />
|
|
||||||
<!-- For routes built with the "Plan route", the parameters of key points are saved. -->
|
|
||||||
<extensions>
|
|
||||||
<!-- Route profile type for next segment (car, bicycle, pedestrian, etc.). -->
|
|
||||||
<profile>...</profile>
|
|
||||||
<!-- The index of the point in the gpx segment that corresponds to the first point of the calculated route for this segment. -->
|
|
||||||
<trkpt_idx>...</trkpt_idx>
|
|
||||||
</extensions>
|
|
||||||
</rtept>
|
|
||||||
</rte>
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Example:
|
|
||||||
```xml
|
|
||||||
<gpx version="1.1" creator="OsmAndRouterV2" xmlns="http://www.topografix.com/GPX/1/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
|
|
||||||
<metadata>
|
|
||||||
<name>Fri 06 Nov 2020</name>
|
|
||||||
</metadata>
|
|
||||||
<trk>
|
|
||||||
<name>Fri 06 Nov 2020</name>
|
|
||||||
<trkseg>
|
|
||||||
<trkpt lat="52.3639849" lon="4.8900533">
|
|
||||||
<ele>0.801</ele>
|
|
||||||
</trkpt>
|
|
||||||
<trkpt lat="52.3636917" lon="4.8922849">
|
|
||||||
<ele>0.998</ele>
|
|
||||||
</trkpt>
|
|
||||||
<trkpt lat="52.3636885" lon="4.892309">
|
|
||||||
<ele>1</ele>
|
|
||||||
</trkpt>
|
|
||||||
<trkpt lat="52.3636426" lon="4.8922902">
|
|
||||||
<ele>0.963</ele>
|
|
||||||
</trkpt>
|
|
||||||
<trkpt lat="52.363564" lon="4.8922607">
|
|
||||||
<ele>0.899</ele>
|
|
||||||
</trkpt>
|
|
||||||
|
|
||||||
....
|
|
||||||
|
|
||||||
<extensions>
|
|
||||||
<route>
|
|
||||||
<segment id="7372058" length="3" segmentTime="178.44" speed="1.11" turnType="C" types="0,1,2,3,4,5,6" names="57" />
|
|
||||||
<segment id="334164679" length="5" segmentTime="86.11" speed="1.11" turnType="TR" turnAngle="91.88" types="7,8,0,9,10,11,12,13,6" pointTypes=";;14,15;16,17,18;" names="58" />
|
|
||||||
<segment id="334603581" length="6" segmentTime="75.5" speed="1.11" types="19,20,21,7,8,0,22,9,10,11,12,13,23,6" pointTypes=";14;16,24;16,24;14;" names="58" />
|
|
||||||
<segment id="446707354" length="3" segmentTime="8.32" speed="1.11" turnType="TSLL" turnAngle="-25.44" types="19,25,21,7,8,22,9,1,11,12,13,6" names="58" />
|
|
||||||
...
|
|
||||||
</route>
|
|
||||||
<types>
|
|
||||||
<type t="lit" v="yes" />
|
|
||||||
<type t="oneway" v="yes" />
|
|
||||||
<type t="highway" v="unclassified" />
|
|
||||||
<type t="surface" v="paving_stones" />
|
|
||||||
<type t="maxspeed" v="30" />
|
|
||||||
...
|
|
||||||
</types>
|
|
||||||
</extensions>
|
|
||||||
</trkseg>
|
|
||||||
</trk>
|
|
||||||
|
|
||||||
<rte>
|
|
||||||
<rtept lat="52.3639945" lon="4.8900532">
|
|
||||||
<extensions>
|
|
||||||
<profile>pedestrian</profile>
|
|
||||||
<trkpt_idx>0</trkpt_idx>
|
|
||||||
</extensions>
|
|
||||||
</rtept>
|
|
||||||
<rtept lat="52.3612797" lon="4.8911677">
|
|
||||||
<extensions>
|
|
||||||
<profile>pedestrian</profile>
|
|
||||||
<trkpt_idx>24</trkpt_idx>
|
|
||||||
</extensions>
|
|
||||||
</rtept>
|
|
||||||
<rtept lat="52.356996" lon="4.8912071">
|
|
||||||
<extensions>
|
|
||||||
<profile>pedestrian</profile>
|
|
||||||
<trkpt_idx>89</trkpt_idx>
|
|
||||||
</extensions>
|
|
||||||
</rtept>
|
|
||||||
<rtept lat="52.3542374" lon="4.8947024">
|
|
||||||
<extensions>
|
|
||||||
<profile>pedestrian</profile>
|
|
||||||
<trkpt_idx>121</trkpt_idx>
|
|
||||||
</extensions>
|
|
||||||
</rtept>
|
|
||||||
</rte>
|
|
||||||
</gpx>
|
|
||||||
```
|
|
||||||
Loading…
Reference in a new issue