GPXM-file

What's a GPXM-file

A GPXM-file is a digital representation of the route you can create and see on RouteYou. GPXM is the format, based and compatible with GPX (GPS eXchange Format), but extended with a set of features to make full use of the content provided and created on RouteYou.

Below you can see a detailed example of a GPXM file.

Since GPXM is compatible with GPX, you will find most of the explenation of the meaning of the tags in the standard documentation of GPX. This is s good spot to start from.

Overview of the main extensions

Extra info on metadata

Language

The extra info is indicated by the standard GPX tag

<extensions></extensions>

An example

<metadata>
<extensions>
<gpxmedia>
<gpxinfos>
<name lang="en">Isle of Wight Cycling Route</name>
<desc lang="en">Cycling route of the Isle of Wight, based on the cycling tour of cycling route author Briarcliff. You will follow the tracks of famous people such as Charles Darwin, Dickens, Garibaldi and even Karl Marx.</desc>
</gpxinfos>
</gpxmedia>
</extensions>
</metadata>

An extra lang (language) attribute is provided to the tags

This allows

Extra info on a waypoint or WPT

The extra info is indicated by the standard GPX tag

<extensions></extensions>

The example below shows some extra tags for a WPT.

<wpt lat="50.6339365843" lon="-1.17987682594">
<name>Shanklin Rail Station</name>
<type>Trainstation</type>
<extensions>
<gpxmedia>
<wptinfos>
<sym>http://www.ontracknavigation.com/ws/icons/profile/inactive/s_25_Railwaystation.png</sym>
<name lang="en">Shanklin Rail Station</name>
</wptinfos>
<medias>
<media lang="en">
<type>text</type>
<content>Shanklin Rail Station is the end of one of the most punctual rail road lines in the UK. The rail route from Ryde to Shanklin. It is the present terminus of the Island Line from Ryde.</content>
</media>
<media lang="all">
<type>image</type>
<source>
<url>http://en.wikipedia.org/wiki/File:Wightbus_5862_HW54_DCE_and_Shanklin_railway_station_2.JPG</url>
</source>
<url>http://storage.routeyou.com/image/thumbnail/width/300/height/300/filename/4af4645a45a617319efd38264a96406d_b4a3d022c7e0d7d32f328d4ce4b9216fc0b4d724.jpeg</url>
</media>
</medias>
</gpxmedia>
</extensions>
</wpt>

sym

The tag sym is used to provide a link to a symbol we use to represent the type of waypoint or POI. http://www.ontracknavigation.com/ws/icons/profile/inactive/s_25_Railwaystation.png

lang

The language attribute is used for the name tag, so you know which language it is, and/or you can store multiple names in several languages. RouteYou uses default the same language per route/GPXM.

type

Type is a subtag of media. A media can be of several types.

In the case of text, it has an extra sub tag (content) to provide the content. In the case of image, it has an extra sub tag (url) to refer to the image file

E.g. http://storage.routeyou.com/image/thumbnail/width/300/height/300/filename/4af4645a45a617319efd38264a96406d_b4a3d022c7e0d7d32f328d4ce4b9216fc0b4d724.jpeg

To optimize your download of the image, your can use the server-side resampling of RouteYou. You will see that the URL contains a part width/300/height/300 . This indicates that the size of the image will be max 3OO with or max 300 height. If you want it smaller, just put a smaller number. Here below an example. http://storage.routeyou.com/image/thumbnail/width/100/height/100/filename/4af4645a45a617319efd38264a96406d_b4a3d022c7e0d7d32f328d4ce4b9216fc0b4d724.jpeg

How to get to the GPXM-file

The manual way

Via the download button of a route page, you get to see the GPXM file. Thi sis provided for all new routes (there are still a few old routes we don't provide with a GPXM, but these are exceptions, but they do exist!).

Via web service

The route web service provides you a solution to download the files via getRouteFiles.

Example of a GPXM file

Here is a link to a GPXM file.

© 2006-2018 RouteYou - www.routeyou.com