gpx-parser-builder

gpx-parser-builder

A simple gpx parser and builder between GPX string and JavaScript object. It is dependent on fast-xml-parser.

Requirements

gpx-parser-builder is written with ECMAScript 6 and is now an ES Module.

Installation

npm install gpx-parser-builder --save

Usage

import GPX from 'gpx-parser-builder';

// Parse gpx
const gpx = GPX.parse('GPX_STRING');

window.console.dir(gpx.metadata);
window.console.dir(gpx.wpt);
window.console.dir(gpx.trk);

// Build gpx
window.console.log(gpx.toString());

Get more details about usage with the unit tests.

GPX

The GPX JavaScript object.

constructor(object)

const gpx = new Gpx({$:{...}, metadat: {...}, wpt:[{...},{...}]}, trk: {...}, rte: {...})

Member Variables

$ the attributes for the gpx element. Default value:

{
    'version': '1.1',
    'creator': 'gpx-parser-builder',
    '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 the metadata for the gpx.

wpt array of waypoints. It is corresponded to <wpt>. The type of all elements in wpt is Waypoint;

rte array of routes. It is corresponded to <rte>. The type of all elements in rte is Route;

trk array of tracks. It is corresponded to <trk>. The type of all elements in trk is Track;

Static Methods

parse(gpxString, options) parse gpx string to Gpx object. return null if parsing failed. The options is for fast-xml-parser's XMLParser.

Member Methods

toString(options) GPX object to gpx string. The options is for fast-xml-parser's XMLBuilder.

Save as GPX file in the frontend

You can leverage StreamSaver.js or FileSaver.js to save as GPX file. ⚠️Not all borwsers support the above file techniques. ⚠️️️

Author

Ke Zheng-Xiang, [e-mail]

License

gpx-parser-builder is available under the MIT license. See the LICENSE file for more info.