Tech Support Knowledgebase Browse
 
Tools
Rss Categories

Hema Explorer [General] - Importing GPX trek files downloaded from the Boiling Billy website

Author: Robert Taylor Reference Number: AA-00460 Views: 11215 Created: 2014-07-24 14:33 Last Updated: 2014-11-20 14:34 83 Rating/ 3 Voters

The Boiling Billy website at http://www.boilingbilly.net.au/ has free GPX files you can download which go with the Boiling Billy 4WD Treks series of books.

There is a downloadable ZIP file for each book.

Each download has individual treks split up into seperate folders etc.

Each trek GPX file contains a series of WAYPOINTS. If all you want to do is import these files into Hema Explorer as waypoints, then you can import them using the Cloud (http://cloud.hemaexplorer.com.au) Upload File feature (see http://help.hema-labs.com/cloud/webhelp/uploading_track_files.htm).

The only problem with this is that the upload file feature expects to see a GPX TRACK (or ROUTE) file, and NOT a file containing a bunch of waypoints.

If you want to use these files as a route within the Hema Explorer app, you need to do a bit of conversion work beforehand.

Here is what you need to do:

Some Useful Things to Know

A GPX file is simply a text file with a specific format for specifying the following types of GPS information:

  • Waypoints
  • Tracks
  • Routes

There are some useful tools available on the internet for free which you can use to manipulate GPX files, such as:

  • GPSBabel (http://www.gpsbabel.org/) FREE/Donationware GPSBabel is a useful tool for converting GPS data from one format to another (for example OziExplorer Waypoints, to a GPX Route)
  • GPS Track Editor (http://www.gpstrackeditor.com/) FREE GPS Track Editor is a nice tool for editing track logs in GPX format. (note it will only open files which contain valid TRACK data, not routes or waypoints - that's why it's called GPS TRACK Editor)

We are going to use GPSBabel in our little exercise here, so if you want to be able to do this, you will need to download and install GPSBabel on your PC from their website.

You will most likely have downloaded one or more of the Boiling Billy files from their website. They provide the data in ZIP files, so you will need to unzip the file(s) first.

A Bit About GPX files

GPX files are simply text files, so you can open them with any text editor like Notepad, or the freely available Notepad++.

Once the file(s) are unzipped, if you open one in Notepad, you will see something similar to the following (only part of the file is shown here, the center section has been removed to shorten the listing):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gpx
 xmlns="http://www.topografix.com/GPX/1/1"
 creator="OziExplorer Version 3955s - http://www.oziexplorer.com"
 version="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>
 <time>2013-10-24T04:41:58Z</time>
 <bounds minlat="-27.068870" minlon="153.129580" maxlat="-26.854030" maxlon="153.203760"/>
</metadata>
<wpt lat="-27.0688700" lon="153.2037600">
 <ele>-39.000000</ele>
 <time>2013-10-24T04:35:01.441Z</time>
 <name>TREK 1 WPT 1</name>
 <cmt>Ped. Crossing</cmt>
 <desc>Ped. Crossing</desc>
 <sym>Waypoint</sym>
</wpt>
<wpt lat="-27.0593500" lon="153.1988800">
 <ele>-43.000000</ele>
 <time>2013-10-24T04:35:24.678Z</time>
 <name>TREK 1 WPT 2</name>
 <cmt>YJ from south</cmt>
 <desc>YJ from south</desc>
 <sym>Waypoint</sym>
</wpt>
<wpt lat="-27.0435100" lon="153.1894000">
 <ele>-37.000000</ele>
 <time>2013-10-24T04:35:41.475Z</time>

.

.

.

<desc>Fort Bribie</desc>
 <sym>Waypoint</sym>
</wpt>
<wpt lat="-26.8540300" lon="153.1295800">
 <ele>-25.000000</ele>
 <time>2013-10-24T04:38:59.642Z</time>
 <name>TREK 1 WPT 11</name>
 <cmt>Northern Search Light Post; SP Vehicles Prohibited Beyound This Point</cmt>
 <desc>Northern Search Light Post; SP Vehicles Prohibited Beyound This Point</desc>
 <sym>Waypoint</sym>
</wpt>
</gpx>

As you can see, a GPX file is an XML file which contains specific tags containing the data. In some way it looks similar to an HTML file (a web page).

It is not important that you know what all the tags etc. are, but it is worth noting some of the structures you see here.

Most XML tags have an START and corresponding END tag. Most closing tags have the same name as the opening tag, but prefixed with a "/" to signify that they close that tag.

If you look at the listing, you will see that the file as a whole has an opening <gpx tag, and ends with a corresponding </gpx> tag.

There is an opening <metadata> tag, and a corresponding closing </metadata> tag.

Also, for each waypoint defined in this file, the waypoint data is enclosed within a <wpt> and </wpt> tag.

Converting a File From a GPX Waypoints File to a GPX Route File

GPSBabel is designed to perform one function, which it does very well. That is, it is designed to take GPS data in one format, apply a bunch of changes to the file according to your specifications, and then create a new output file containing the original data which has been transformed by the changes you requested.

A simple diagram below shows the process.

GPSBabel process flow


Performing the actual conversion using GPSBabel

Start the GPSBabel program on your PC.

GPSBabel main window

You will see the main GPSBabel window.

If you look at the window, you will see that it is divided up into several logical groups:

  • The Input panel
  • The Translation Options panel
  • The Output panel
  • The Results panel (displays information regarding what is happening)

This makes perfect sense, as these groupings define what GPSBabel does:

  • Read the source file (Input)
  • Make some changes to the format of the file (Translation)
  • Write a new file with the transalation changes applied to the data from the input file (Output)

Basic Steps

These are the basic steps required to perform your conversion (more detail below in the step-by-step section). Once you have done these steps a few times, you will find it quite a simple task to convert your data between formats using GPSBabel.

  1. Select the Input Type
  2. Select the Input Format
  3. Select the Input File
  4. Specify any Filters or Options you wish to apply
  5. Select the Output Type
  6. Select the Output Format
  7. Select the Output File Name
  8. Start the conversion process

Almost all operations using GPSBabel follow the same basic steps.

Step-by-Step guide to converting (translating) a GPX File from Boiling Billy to a GPX Route file for use with Hema Explorer

GPSBabel - Input panel

Set the Input type - File (File should be the default value)

Select the format for the input file from the drop-down list - GPX XML

File Names button

Click the File Name(s) button and browse to where you have the source file stored on your PC.

There is no need to specify any additional input Options.

Translation Options panel

Filters button

Click the Filters button in the Translation Options panel. The Data Filters window will open.

Data Filters windowData Filters window

In the Data Filters window, click the Miscellaneous category in the column at the left.

Make sure the Transform option is ticked.

Click the dropdown-menu, and choose the Waypoint -> Routes option (remember, in this example, we are converting a file containing Waypoints to a Route file).

Make sure the Delete option is ticked. This makes sure that once we turn the waypoints in the source file into a route, we don't also leave the waypoints in there. Leave this option unticked if you do want to have a route AND waypoints in the output file.

OK button

Click the OK button to close the Data Filters window.

Output panel

Set the Output type - File (File should be the default value)

Select the format for the output file from the drop-down list - GPX XML

File Name button

Click the File Name button and browse to where you want to save the output file on your PC.

There is no need to specify any additional output Options.

Once you have completed the steps above, GPSBabel is ready to roll.

The GPSBabel window should look like the example below.

GPSBabel window

OK button

Click the OK button on the main GPSBabel window to start processing.

GPSBabel will read the input file, apply your filters and options, and create the output file. Messages will appear in the results panel at the bottom of the GPSBabel window.

After all the time it took you to setup, you may be surprised at how quickly GPSBabel processes your input file. Of course the time taken depends on what is in the input file. If you were converting a track log, for example, which contained tens of thousands of track points, you would expect it to take a lot longer than a file containing 50 waypoints.

Once processing is complete, the GPSBabel window should look similar to the following. Notice that the results panel shows a message at the bottom saying the translation was successful.

GPSBabel window after processing is complete


Once the file has been converted, if you open it in Notepad, you will see something similar to the following (only part of the file is shown here, the center section has been removed to shorten the listing):

<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1" creator="GPSBabel - http://www.gpsbabel.org" xmlns="http://www.topografix.com/GPX/1/1">
  <metadata>
    <time>2014-07-25T00:18:43.820Z</time>
    <bounds minlat="-27.068870000" minlon="153.129580000" maxlat="-26.854030000" maxlon="153.203760000"/>
  </metadata>
  <rte>
    <rtept lat="-27.068870000" lon="153.203760000">
      <ele>-39.000000</ele>
      <time>2013-10-24T04:35:01.441Z</time>
      <name>TREK 1 WPT 1</name>
      <cmt>Ped. Crossing</cmt>
      <desc>Ped. Crossing</desc>
      <sym>Waypoint</sym>
    </rtept>
    <rtept lat="-27.059350000" lon="153.198880000">
      <ele>-43.000000</ele>
      <time>2013-10-24T04:35:24.678Z</time>
      <name>TREK 1 WPT 2</name>
      <cmt>YJ from south</cmt>
      <desc>YJ from south</desc>
      <sym>Waypoint</sym>
    </rtept>
.

.

.

  </rte>
</gpx>

As you can see, the GPX file now contains different tags to those in the source file.

There are now <rte> and </rte> tags which enclose the Route definition.

Each point which makes up the route is defined by the tag pair of <rtept> and </rtept>.

GPSBabel Close button

After verifying that your file has been converted successfully, you can exit out of GPSBabel by clicking the Close button.


As you now have a usable GPX route file, you can do one of the following:

  1. Copy the GPX route file directly to your device by connecting it via USB cable to your PC. Then use the Import file function to load the Route file into Hema Explorer.
  2. Use the Upload function on the Cloud website to load your Route to your Cloud account at http://cloud.hemaexplorer.com.au/

See the user guides for the app and Cloud at the following links for more information on importing files:

Hema Explorer [iOS] User Guide

Hema Explorer [Android] User Guide

Hema Explorer Cloud User Guide



You might wonder why we don't just convert all the files and post them here. There's a couple of reasons:

  • It might infringe Boiling Billy's copyright
  • Boiling Billy may make changes to some or all of the files which means they'd all have to be converted again
  • It's better to learn how to do some of this stuff yourself; as it's useful knowledge to have, and that's part of the fun!



Please rate articles! It helps us to ensure that you can find relevant information in the Knowledgebase.
You can use the Please rate this article option from the Tools menu at upper-right.
Comments left when rating articles are not replied to, although they are viewed and taken into account.
If you have an issue you need help with, please submit a ticket at Hema Tech Support

Content found in the Knowledgebase is accurate as at time of publication.
Copyright © 2015 Hema Maps Pty Ltd