edu.colorado.cires.cmg.mvt.adapt.jts

Class MvtReader

java.lang.Object

edu.colorado.cires.cmg.mvt.adapt.jts.MvtReader

public final class MvtReader
extends Object

Load Mapbox Vector Tiles (MVT) to JTS Geometry. Feature tags may be converted to user data via ITagConverter.

See Also:

JtsMvt, JtsLayer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MvtReader.RingClassifier Classifies Polygon and MultiPolygon rings.

Field Summary

Fields

Modifier and Type	Field and Description
static MvtReader.RingClassifier	RING_CLASSIFIER_V1 Area for surveyor formula may be positive or negative for exterior rings.
static MvtReader.RingClassifier	RING_CLASSIFIER_V2_1 Area from surveyor formula must be positive for exterior rings.

Constructor Summary

Constructors

Constructor and Description
MvtReader()

Method Summary

Modifier and Type	Method and Description
static JtsMvt	loadMvt(File file, org.locationtech.jts.geom.GeometryFactory geomFactory, ITagConverter tagConverter) Convenience method for loading MVT from file.
static JtsMvt	loadMvt(File file, org.locationtech.jts.geom.GeometryFactory geomFactory, ITagConverter tagConverter, MvtReader.RingClassifier ringClassifier) Convenience method for loading MVT from file.
static JtsMvt	loadMvt(InputStream is, org.locationtech.jts.geom.GeometryFactory geomFactory, ITagConverter tagConverter) Load an MVT to JTS geometries using coordinates.
static JtsMvt	loadMvt(InputStream is, org.locationtech.jts.geom.GeometryFactory geomFactory, ITagConverter tagConverter, MvtReader.RingClassifier ringClassifier) Load an MVT to JTS geometries using coordinates.

Methods inherited from class java.lang.Object

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

Field Detail

RING_CLASSIFIER_V1

public static final MvtReader.RingClassifier RING_CLASSIFIER_V1

Area for surveyor formula may be positive or negative for exterior rings. Mimics Mapbox parsers supporting V1.

RING_CLASSIFIER_V2_1

public static final MvtReader.RingClassifier RING_CLASSIFIER_V2_1

Area from surveyor formula must be positive for exterior rings. Obeys V2.1 spec.

Constructor Detail

MvtReader

public MvtReader()

Method Detail

loadMvt

public static JtsMvt loadMvt(File file,
                             org.locationtech.jts.geom.GeometryFactory geomFactory,
                             ITagConverter tagConverter)
                      throws IOException

Convenience method for loading MVT from file. See loadMvt(InputStream, GeometryFactory, ITagConverter, RingClassifier). Uses RING_CLASSIFIER_V2_1 for forming Polygons and MultiPolygons.

Parameters:

file - path to the MVT

geomFactory - allows for JTS geometry creation

tagConverter - converts MVT feature tags to JTS user data object

Returns:

JTS MVT with geometry in MVT coordinates

Throws:

IOException - failure reading MVT from path

See Also:

loadMvt(InputStream, GeometryFactory, ITagConverter, RingClassifier), Geometry, Geometry.getUserData(), MvtReader.RingClassifier

loadMvt

public static JtsMvt loadMvt(File file,
                             org.locationtech.jts.geom.GeometryFactory geomFactory,
                             ITagConverter tagConverter,
                             MvtReader.RingClassifier ringClassifier)
                      throws IOException

Convenience method for loading MVT from file. See loadMvt(InputStream, GeometryFactory, ITagConverter, RingClassifier).

Parameters:

file - path to the MVT

geomFactory - allows for JTS geometry creation

tagConverter - converts MVT feature tags to JTS user data object

ringClassifier - determines how rings are parsed into Polygons and MultiPolygons

Returns:

JTS MVT with geometry in MVT coordinates

Throws:

IOException - failure reading MVT from path

See Also:

loadMvt(InputStream, GeometryFactory, ITagConverter, RingClassifier), Geometry, Geometry.getUserData(), MvtReader.RingClassifier

loadMvt

public static JtsMvt loadMvt(InputStream is,
                             org.locationtech.jts.geom.GeometryFactory geomFactory,
                             ITagConverter tagConverter)
                      throws IOException

Load an MVT to JTS geometries using coordinates. Uses tagConverter to create user data from feature properties.

Parameters:

is - stream with MVT data

geomFactory - allows for JTS geometry creation

tagConverter - converts MVT feature tags to JTS user data object.

Returns:

JTS MVT with geometry in MVT coordinates

Throws:

IOException - failure reading MVT from stream

See Also:

Geometry, Geometry.getUserData(), MvtReader.RingClassifier

loadMvt

public static JtsMvt loadMvt(InputStream is,
                             org.locationtech.jts.geom.GeometryFactory geomFactory,
                             ITagConverter tagConverter,
                             MvtReader.RingClassifier ringClassifier)
                      throws IOException

Load an MVT to JTS geometries using coordinates. Uses tagConverter to create user data from feature properties.

Parameters:

is - stream with MVT data

geomFactory - allows for JTS geometry creation

tagConverter - converts MVT feature tags to JTS user data object.

ringClassifier - determines how rings are parsed into Polygons and MultiPolygons

Returns:

JTS MVT with geometry in MVT coordinates

Throws:

IOException - failure reading MVT from stream

See Also:

Geometry, Geometry.getUserData(), MvtReader.RingClassifier