GFork

# 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 GNU General Public License v3.0. See the [LICENSE](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 `` 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

```javascript
var geoGPXer = new GeoGPXer(); // Create a new instance of GeoGPXer

// Sample GPX data input
const gpxData = `...your GPX data...`;

// 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.