Android GPX Parser

Additional

Language
Java
Version
v2.2.0 (Nov 25, 2021)
Created
Sep 11, 2015
Updated
Nov 26, 2021
Owner
Fabio Tiriticco (ticofab)
Contributors
Fabio Tiriticco (ticofab)
Sebas LG (sebaslogen)
Stu Stirling (StuStirling)
Hsieh Chin Fan (typebrook)
Serge Helfrich (Pygmalion69)
Taneli Korri (tkorri)
Hans Joachim Herbertz (herberlin)
Vincenzo Vitale TT (VincenzoVitale-TomTom)
Markus Deutsch (moopat)
Tom Sullivan (msbit)
andreasflosdorf
11
Activity
Badge
Generate
Download
Source code

Promotion

Android GPX Parser

A library to parse XML Gpx files, built for Android. The reference schema is the Topografix GPX 1.1.
In addition, it parses the speed extension, when provided as a double number.

Projects using this library:

To have your project listed here, send me an email or open a PR.

Download

Add the Jitpack repository to your root build file. The way you do this depends on the Gradle plugin you are using:

// for gradle plugin 7.0.0 or newer (default for new apps since Android Studio Artic Fox)
// in settings.gradle
dependencyResolutionManagement {
    ...
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
// for older versions, in project-level build.gradle
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Finally, in your dependencies list

dependencies {
    implementation 'com.github.ticofab:android-gpx-parser:2.2.0'
}

Dependencies

Usage

In Java:

GPXParser parser = new GPXParser(); // consider injection
Gpx parsedGpx = null;
try {
    InputStream in = getAssets().open("test.gpx");
    parsedGpx = parser.parse(in); // consider using a background thread
} 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 included example app and tests
}

In Kotlin:

val parser = GPXParser() // consider injection
try {
    val input: InputStream = getAssets().open("test.gpx")
    val parsedGpx: Gpx? = parser.parse(input) // consider using a background thread
    parsedGpx?.let {
        // do something with the parsed track
        // see included example app and tests
    } ?: {
        // error parsing track
    }
} catch (e: IOException) {
    // do something with this exception
    e.printStackTrace()
} catch (e: XmlPullParserException) {
    // do something with this exception
    e.printStackTrace()
}

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

Copyright 2015 - 2021 Fabio Tiriticco - Fabway

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.