GeoGPXer

GeoGPXer is a JavaScript library designed to convert GPX data into GeoJSON format efficiently. It supports the conversion of waypoints, tracks, and routes, with additional handling for GPX extensions.

License

This project is free software licensed under the MIT License. See the LICENSE file for more details.

Overview

GeoGPXer provides an easy-to-use API to parse GPX files and convert them into a GeoJSON FeatureCollection, making it suitable for use in web mapping applications and geographic data visualization.

Features

• Convert GPX to GeoJSON: Supports waypoints, tracks, and routes.
• Handle Extensions: Converts GPX <extensions> to prefixed GeoJSON properties to avoid conflicts.
• No External Dependencies: Lightweight and easy to integrate into various projects.

Usage

To use GeoGPXer, create an instance of GeoGPXer and use its methods to perform the conversion from GPX strings to GeoJSON objects.

Example

var geoGPXer = new GeoGPXer(); // Create a new instance of GeoGPXer
// Sample GPX data input
const gpxData = `...GPX data string...`;
// Parse the GPX data
const xmlDoc = geoGPXer.read(gpxData);
// Convert to GeoJSON
const geoJson = geoGPXer.toGeoJSON(xmlDoc);
console.log(geoJson);

Key Methods

• read(gpxText): Parses a GPX string into an XML Document using DOMParser.
• toGeoJSON(document): Converts an XML Document into a GeoJSON FeatureCollection.
• extractProperties(node): Extracts properties from a GPX node, including handling of by prefixing property names.

Acknowledgments

The code in this project is derived from the logic of gpx2geojson by M-Reimer.

Project Home

https://github.com/JS55CT/GeoGPXer