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
- name
- desc
This allows
- to indicate the language(s) used for the name (title) of a route and the description
- to store multiple translations in the file (the standard is that we keep a route per language, but the format allows to store multi-language information.
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>https://image.routeyou.com/shrink/fit/300x300/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.
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.
- text
- image
- video
- sound
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. https://image.routeyou.com/shrink/fit/300x300/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.
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.