de.k3b.geo.io.gpx

Class GpxReader<T extends IGeoPointInfo>

java.lang.Object

org.xml.sax.helpers.DefaultHandler

de.k3b.geo.io.gpx.GpxReaderBase

de.k3b.geo.io.gpx.GpxReader<T>

All Implemented Interfaces:

IGeoInfoHandler, org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class GpxReader<T extends IGeoPointInfo>
extends GpxReaderBase
implements IGeoInfoHandler

Class to read List of IGeoPointInfo points from gpx/kml/xml/… file or stream.

GpxReader<IGeoPointInfo> parser = new GpxReader<IGeoPointInfo>();
List<IGeoPointInfo> points = parser.getTracks(new InputSource(new FileReader( "test.gpx")));
for (IGeoPointInfo geo : points) {
   System.out.print(String.format("got lat=%f lon=%f\n", geo.getLatitude(),geo.getLongitude()));
}

Supported formats:

• gpx-1.0 and gpx-1.1 files
• kml-2.2 files used by google
• wikimedia that is used by web-apis of wikipedia and wikivoyage
• poi files, k3b-s internal xml format

Inspired by http://stackoverflow.com/questions/672454/how-to-parse-gpx-files-with-saxreader

Field Summary

Fields inherited from class de.k3b.geo.io.gpx.GpxReaderBase

current, mReuse, onGotNewWaypoint

Constructor Summary

Constructors

Constructor and Description
GpxReader() Creates a new GpxReader.
GpxReader(GeoPointDto reuse) Creates a new GpxReader.

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<T>	getTracks(org.xml.sax.InputSource in) Call the parser and return the points contained in the stream
boolean	onGeoInfo(IGeoPointInfo geoInfo) Is called for every completed gpx-trackpoint to collect the received tracks.

Methods inherited from class de.k3b.geo.io.gpx.GpxReaderBase

characters, createGeoUriParser, endElement, newInstance, newInstance, parse, startElement

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GpxReader

public GpxReader()

Creates a new GpxReader.

Since:

1.1.5

GpxReader

public GpxReader(GeoPointDto reuse)

Creates a new GpxReader.

Parameters:

reuse - if not null this instance is cleared and then reused for every new gpx found. This way the reader can load different implementations of IGeoPointInfo

Method Detail

getTracks

public java.util.List<T> getTracks(org.xml.sax.InputSource in)
                                                  throws java.io.IOException

Call the parser and return the points contained in the stream

Throws:

java.io.IOException

onGeoInfo

public boolean onGeoInfo(IGeoPointInfo geoInfo)

Is called for every completed gpx-trackpoint to collect the received tracks.

Specified by:

onGeoInfo in interface IGeoInfoHandler

Returns:

true if item has been consumed