Guides
Guides

GPX

GPX (the GPS Exchange Format) is a light-weight XML data format for the interchange of GPS data (waypoints, routes, and tracks) between applications and web services on the internet.

GPX 1.1 schema is followed for parsing and mapping to JavaBeans.

A GPX message carries this data:

  • Waypoints are coordinates of a point and represent a layer of features of OGR type wkbPoint.
  • Routes are pre-defined paths created from groups of waypoints.
  • Tracks are the recording of the actual trip. They act like breadcrumb trails, allowing you to see where an entity travelled in the past.
📘

Note

HERE Anonymizer Self-Hosted anonymizes only tracks of a GPX message since this is the element that contains actual trip data that could be used to identify an individual.

GPX message example

<?xml version='1.0' encoding='UTF-8'?>
<gpx version="1.1" creator="https://www.example.com" 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>Example GPX Document</name>
    <author>
      <link href="https://www.example.com">
        <text>example</text>
        <type>text/html</type>
      </link>
    </author>
  </metadata>
  <trk>
    <name>Example GPX track</name>
    <trkseg>
      <trkpt lat="54.193370" lon="12.146873">
        <ele>34.510784</ele>
        <time>2019-08-25T09:21:59.000Z</time>
      </trkpt>
      <trkpt lat="54.193375" lon="12.146661">
        <ele>34.510784</ele>
        <time>2019-08-25T09:22:04.000Z</time>
      </trkpt>
      <trkpt lat="54.193306" lon="12.146851">
        <ele>34.510784</ele>
        <time>2019-08-25T09:22:05.000Z</time>
      </trkpt>
      <trkpt lat="54.193230" lon="12.147102">
        <ele>34.510784</ele>
        <time>2019-08-25T09:22:06.000Z</time>
      </trkpt>
    </trkseg>
  </trk>
</gpx>
ElementDescription
gpxRoot element of the XML file.
metadataContains information about the GPX data.
trkTrack data consists of track segments that contains collections of track points.
trksegThe track segment part of the track data.
trkptA track point that contains latitude, longitude, elevation, and timestamp information.
📘

Note

For GPX data format please set attributes.extendedAttributes.keep and attributes.extendedAttributes.message in configuration (anonymizer.conf) as below.

attributes {
  extendedAttributes {
    keep: true
    message: ["xmlns", "xmlns:xsi", "xsi:schemaLocation","xmlns:gpxx","xmlns:gpxtpx",
    "metadata.name",
    "metadata.desc",
    "metadata.time",
    "metadata.keywords",
    "metadata.author.link._href",
    "metadata.author.link.text"
    "metadata.author.link.type",
    "metadata.copyright.year",
    "metadata.copyright.license",
    "metadata.copyright._author",
    "metadata.link._href",
    "metadata.link.text",
    "metadata.link.type",
    "metadata.bounds._maxlat",
    "metadata.bounds._minlat",
    "metadata.bounds._maxlon",
    "metadata.bounds._minlon",
    ]
    point: []
  }
}