Class: GPX


import GPX from 'ol/format/GPX';

Feature format for reading and writing data in the GPX format.

Note that module:ol/format/GPX~GPX#readFeature only reads the first feature of the source.

When reading, routes (<rte>) are converted into LineString geometries, and tracks (<trk>) into MultiLineString. Any properties on route and track waypoints are ignored.

When writing, LineString geometries are output as routes (<rte>), and MultiLineString as tracks (<trk>).

new GPX(opt_options)

format/GPX.js, line 117
Name Type Description


Name Type Description
readExtensions function

Callback function to process extensions nodes. To prevent memory leaks, this callback function must not store any references to the node. Note that the extensions node is not allowed in GPX 1.0. Moreover, only extensions nodes from wpt, rte and trk can be processed, as those are directly mapped to a feature.


writeFeaturesNode(features, opt_options){Node}

format/GPX.js, line 209

Encode an array of features in the GPX format as an XML node. LineString geometries are output as routes (<rte>), and MultiLineString as tracks (<trk>).

Name Type Description
features Array.<module:ol/Feature~Feature>




Name Type Description
dataProjection module:ol/proj~ProjectionLike

Projection of the data we are writing. If not provided, the dataProjection of the format is assigned (where set). If no dataProjection is set for a format, the features will be returned in the featureProjection.

featureProjection module:ol/proj~ProjectionLike

Projection of the feature geometries that will be serialized by the format writer. If not provided, geometries are assumed to be in the dataProjection if that is set; in other words, they are not transformed.

rightHanded boolean

When writing geometries, follow the right-hand rule for linear ring orientation. This means that polygons will have counter-clockwise exterior rings and clockwise interior rings. By default, coordinates are serialized as they are provided at construction. If true, the right-hand rule will be applied. If false, the left-hand rule will be applied (clockwise for exterior and counter-clockwise for interior rings). Note that not all formats support this. The GeoJSON format does use this property when writing geometries.

decimals number

Maximum number of decimal places for coordinates. Coordinates are stored internally as floats, but floating-point arithmetic can create coordinates with a large number of decimal places, not generally wanted on output. Set a number here to round coordinates. Can also be used to ensure that coordinates read in can be written back out with the same number of decimals. Default is no rounding.