Android GPX Parser

A library to parse XML Gpx files, built for Android. The reference schema is the Topografix GPX 1.1. Far from complete - pull requests are welcome!

Download

Grab via Gradle:

api 'io.ticofab.androidgpxparser:parser:1.3.0'
// compile 'io.ticofab.androidgpxparser:parser:1.3.0' - for gradle plugin < 3.0.0

Dependencies

Joda DateTime for Android

Usage

Get a parser instance:

GPXParser mParser = new GPXParser(); // consider injection

Then there are two options: given an InputStream,

Gpx parsedGpx = null;
try {
    InputStream in = getAssets().open("test.gpx");
    parsedGpx = mParser.parse(in);
} catch (IOException | XmlPullParserException e) {
    // do something with this exception
    e.printStackTrace();
}
if (parsedGpx == null) {
    // error parsing track
} else {
    // do something with the parsed track
    // see the included example app
}

or you might want to fetch the Gpx track from a server and parse it. In that case, pass the track Url and a listener. Both fetching and parsing happen on a background thread.

mParser.parse("http://myserver.com/track.gpx", new GpxFetchedAndParsed() {
            @Override
            public void onGpxFetchedAndParsed(Gpx gpx) {
                if (gpx == null) {
                    // error parsing track
                } else {
                    // do something with the parsed track
                }
            }
        });

Contribute

Contributions are welcome! Please check the issues and open a pull request when done: you will have made the world a better place.

License