User Tools

Site Tools


standards:gpx_extensions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
standards:gpx_extensions [2012/08/10 23:04]
mjallison
standards:gpx_extensions [2013/10/24 16:27] (current)
mjallison [Extensions]
Line 84: Line 84:
 </​code>​ </​code>​
 ====== Extensions ====== ====== Extensions ======
 +
 +Each extension is wrapped in an **<​agtek>​** tag. This tag indicates that AGTEK define extensions are coming up. 
 +
 +**Track Extensions**
 +
 +There is just one extensions at the file (track) level. This extension is optional and indicates the type of GPS device which was used to record the track. If the extension is absent, the application should assume a "​generic"​ GPS device. Currently the Android platform uses this extension to pick the correct shape of device to draw on the grade rod. No other information about the device should be inferred from the provider name. If additional information is required, it should be provided in this extension section. ​
 +
 +<​code>​
 +  <​extensions>​
 +     <​agtek>​
 +        <​provider>​Leica</​provider>​
 +     </​agtek>​
 +  </​extensions>​
 +</​code>​
 +
 +Valid provider names are:
 +  * Altus
 +  * AltusCell
 +  * Leica
 +  * LeicaCell
 +  * Topcon
 +  * TopconCell
 +  * Trimble
 +  * NMEA (non RTK quality).
 +  * Builtin (functionally equivalent to an NMEA device, not RTK quality). ​
 +
 +**Track Point Extensions**
 +
 +Each track point (trkpt) can has a few extensions to accomodate AGTEK Software. An example track point (with all extensions, looks like):
 +
 +<​code>​
 +      <trkpt lat="​37.69882038778071"​ lon="​-121.81280981721213">​
 +        <​ele>​86.87749096378684</​ele>​
 +        <​time>​2012-05-21T14:​29:​25.171-0700</​time>​
 +        <​extensions>​
 +           <​agtek>​
 +              <​status-fixtype>​Fixed</​status-fixtype>​
 +              <​status-satellite>​8-0</​status-satellite>​
 +              <​compass>​64.245964</​compass>​
 +              <​x>​-5096.123</​x>​
 +              <​y>​1037.987</​y>​
 +              <​z>​394.7</​z>​
 +           </​agtek>​
 +        </​extensions>​
 +      </​trkpt>​
 +</​code>​
 +
 +Each of the following extensions are optional and are defined as follows.
 +
 +**status-fixtype**
 +
 +The fixtype of each track point is one of the following:
 +  * Fixed
 +  * Float
 +  * DGPS
 +  * Auto
 +If this extension is not present, the application should consider that the point is Autonomous. The fix type values must be spelled (case is significant) exactly like they are presented here. 
 +
 +**status satellite**
 +
 +The satellite status is composed of two integers separated by a minus (dash) "​-"​ character. These two values represent the number GPS and Glonass satellites used for this this track point. ​
 +Applications are not required to do anything with this extension.
 +
 +**compass**
 +
 +This represents the value of a some sort of compass bearing in use when this point was recorded. Some recording devices may make use of a hardware compass, others may calculate using other criteria. This value is always relative to TRUE NORTH and is measured in degrees.
 +
 +**x**
 +
 +The X coordinate of the track point, decimal units. Currently this is not used in Android, and is not defined if it is Feet or Meters. This is TBD.
 +
 +**y**
 +
 +The Y coordinate of the track point, decimal units. Currently this is not used in Android, and is not defined if it is Feet or Meters. This is TBD.
 +
 +**z**
 +
 +The Z coordinate of the track point, decimal units. Currently this is not used in Android, and is not defined if it is Feet or Meters. This is TBD.
standards/gpx_extensions.1344639870.txt.gz · Last modified: 2012/10/10 06:48 (external edit)