This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
standards:gpx_extensions [2012/08/10 23:02] mjallison |
standards:gpx_extensions [2013/10/24 16:27] (current) mjallison [Extensions] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Background ====== | ====== Background ====== | ||
- | AGTEK is using GPX files to record tracks and simulations on the Android platform. The use of GPX may also be useful on other platforms, desktop computers, etc. The core portion of GPX is fine for most of our uses (currently - August 2012), but there are some additional bits of information we need. These extra pieces of information are coded into the GPX file using the extension mechanism. To be of maximum use, all AGTEK applications should use the same extensions. This document covers the format of the AGTEK GPX files so other applications can be as compatible as possible. | + | AGTEK is using GPX files to record tracks and simulations on the Android platform. Largely we follow the [[http://www.topografix.com/gpx.asp|GPX Standard]]. The use of GPX may also be useful on other platforms, desktop computers, etc. The core portion of GPX is fine for most of our uses (currently - August 2012), but there are some additional bits of information we need. These extra pieces of information are coded into the GPX file using the extension mechanism. To be of maximum use, all AGTEK applications should use the same extensions. This document covers the format of the AGTEK GPX files so other applications can be as compatible as possible. |
**General comments about using GPX.** | **General comments about using GPX.** | ||
Line 11: | Line 11: | ||
* Apropos of the GPX standard, coordinates must be LAT/LON/ELEV measured in decimal degrees, and meters of elevation. | * Apropos of the GPX standard, coordinates must be LAT/LON/ELEV measured in decimal degrees, and meters of elevation. | ||
- | See the [[GPX standard]] for the documentation on the standardized portions of the format. | + | See the [[http://www.topografix.com/gpx.asp|GPX Standard]] for the documentation on the standardized portions of the format. |
An example GPX file looks like: | An example GPX file looks like: | ||
Line 85: | Line 85: | ||
====== 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. |