gpsformats4j

GPS format conversions in Java.

GPL-3.0 License

Stars
2

gpsformats4j

GPS format conversions in Java.

Very simple, very hacky. ;-) The main reason was to be able to convert TCX files exported from a proprietary app into GPX ones so the OsmAnd~ app can display them.

Supported formats

Currently the following formats are supported:

  • CSV (requires columns in this order: track, time, lat, lon, elevation)
  • GPX
  • TCX
  • KML (only LineString tag)

Example usage

Using it with the provided convert/convert.bat scripts:

./convert --in_file test.tcx --in_format TCX --out_file out.gpx --out_format GPX

Calling the Convert class directly:

java -cp "./lib/*" com.github.fracpete.gpsformats4j.Convert \
  --in_file test.tcx --in_format TCX --out_file out.gpx --out_format GPX

Using Java code:

import com.github.fracpete.gpsformats4j.Convert;
import java.io.File;
...
Convert convert = new Convert();
convert.setInputFile(new File("test.tcx"));
convert.setInputFormat("TCX");
convert.setOutputFile(new File("out.gpx"));
convert.setOutputFormat("GPX");
String msg = convert.execute();
// successful if null returned:
if (msg != null)
  System.err.println(msg);

Releases

The following releases are available:

Maven

Use the following dependency to include the library in your Maven project:

    <dependency>
      <groupId>com.github.fracpete</groupId>
      <artifactId>gpsformats4j</artifactId>
      <version>0.0.5</version>
    </dependency>