GPX Notes

GPX Notes

This page contains miscellaneous notes about the way in which various programs and people use the GPX file format.

EasyGPS is listed first, as this program is written by the people who define the GPX format.

GPX Waypoint Writing Behaviour

Creator wpt rtept repeated as wpt rtept fields extensions
name cmt desc sym type ele extensions
EasyGPS Waypoint ID (10 character limit on output) Comment (one-line) Description (multi-line) Airport – Zoo Waypoint label/label_text: Displayed on EasyGPS map, used as source for waypoint ID yes active_point: selected location
MemoryMap Any, default of “Mark” (duplicates allowed) not output “Dot”, “House”, etc. plus user-defined icons. Default of “Dot” if created in MemoryMap Arbitrary, default of “Marks” if created in MemoryMap not output none known no name, sym, type none known
Adventure Cycling Waypoint ID Brief description same as name Waypoint, Campground, Hotel, Convenience Store, Museum, Restaurant same as sym yes label/label_text: same as name yes none known
st2gpx Microsoft pushpin name not used Microsoft pushpin description Microsoft pushpin symbol number not used none known yes none known

GPX Waypoint Reading Behaviour

Reader wpt rtept duplicated as wpt Comments
name cmt desc label
EasyGPS used for waypoint Waypoint, only displayed in table and edit popup. Also copied for Label, if not otherwise specifiedwhich appears as point label on map used for waypoint Comment, only displayed in table and edit popup used for waypoint Description, appears as tooltip on map used for waypoint Label, appears as point label on map Route points and waypoints listed together, any duplicates ignored. Duplicates are where location is same and name is the same, or name is empty/missing in either (in which case rtept name (if any) is used). Locations are compared to within ~3-4 decimal places of latitude (probably 5 metres). Editing waypoint location changes the associated routepoint location, if any.
MemoryMap (must be non-empty and unique) Appended to cmt - i.e. the desc is lost.
Google Earth used for Waypoints placemark names ignored ignored ignored Route points and waypoint icons, if requested, are created separately, so duplication in the GPX results in duplication in GE. Google Earth users are better served by downloading the KMZ format.

GPX Route Writing Behaviour

Creator rte rtept
name number type name cmt desc sym type ele extensions
EasyGPS
MemoryMap default of “Route” default of “Route” “WPnnnn” (1st 99!) or “WPnnnnn”(!) “Dot” “Waypoints”
Adventure Cycling
st2gpx

GPX Route Reading Behaviour

Reader rte rtept Comments
name desc number name cmt desc
EasyGPS used for route Name, only displayed in edit popup used for route Description, appears as a tooltip on map used for route Number, only displayed in edit popup used to compare with wpt name, retained but not displayed retained but not displayed ignored Editing a waypoint location changes the associated routepoint location, if any.
MemoryMap (must be non-empty and unique)
Google Earth ignored ignored ignored used for Routes Route placemark names ignored ignored Google Earth users are better served by downloading the KMZ format.