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

Class JtsAdapter

java.lang.Object

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

public final class JtsAdapter
extends Object

Adapt JTS Geometry to 'Mapbox Vector Tile' objects.

Constructor Summary

Constructors

Constructor and Description
JtsAdapter()

Method Summary

Modifier and Type	Method and Description
static TileGeomResult	createTileGeom(org.locationtech.jts.geom.Geometry g, org.locationtech.jts.geom.Envelope tileEnvelope, org.locationtech.jts.geom.GeometryFactory geomFactory, MvtLayerParams mvtLayerParams, IGeometryFilter filter) Create geometry clipped and then converted to MVT 'extent' coordinates.
static TileGeomResult	createTileGeom(List<org.locationtech.jts.geom.Geometry> g, org.locationtech.jts.geom.Envelope tileEnvelope, org.locationtech.jts.geom.Envelope clipEnvelope, org.locationtech.jts.geom.GeometryFactory geomFactory, MvtLayerParams mvtLayerParams, IGeometryFilter filter) Create geometry clipped and then converted to MVT 'extent' coordinates.
static TileGeomResult	createTileGeom(List<org.locationtech.jts.geom.Geometry> g, org.locationtech.jts.geom.Envelope tileEnvelope, org.locationtech.jts.geom.GeometryFactory geomFactory, MvtLayerParams mvtLayerParams, IGeometryFilter filter) Create geometry clipped and then converted to MVT 'extent' coordinates.
static List<org.locationtech.jts.geom.Geometry>	flatFeatureList(org.locationtech.jts.geom.Geometry geom) Recursively convert a Geometry, which may be an instance of GeometryCollection with mixed element types, into a flat list containing only the following Geometry types:
static List<VectorTile.Tile.Feature>	toFeatures(Collection<org.locationtech.jts.geom.Geometry> flatGeoms, MvtLayerProps layerProps, IUserDataConverter userDataConverter) Convert a flat list of JTS Geometry to a list of vector tile features.
static List<VectorTile.Tile.Feature>	toFeatures(org.locationtech.jts.geom.Geometry geometry, MvtLayerProps layerProps, IUserDataConverter userDataConverter) Convert JTS Geometry to a list of vector tile features.
static VectorTile.Tile.GeomType	toGeomType(org.locationtech.jts.geom.Geometry geometry) Get the MVT type mapping for the provided JTS Geometry.

Methods inherited from class java.lang.Object

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

Constructor Detail

JtsAdapter

public JtsAdapter()

Method Detail

createTileGeom

public static TileGeomResult createTileGeom(org.locationtech.jts.geom.Geometry g,
                                            org.locationtech.jts.geom.Envelope tileEnvelope,
                                            org.locationtech.jts.geom.GeometryFactory geomFactory,
                                            MvtLayerParams mvtLayerParams,
                                            IGeometryFilter filter)

Create geometry clipped and then converted to MVT 'extent' coordinates. Result contains both clipped geometry (intersection) and transformed geometry for encoding to MVT.

Uses the same tile and clipping coordinates. May cause rendering issues on boundaries for polygons or line geometry depending on styling.

Parameters:

g - original 'source' geometry

tileEnvelope - world coordinate bounds for tile

geomFactory - creates a geometry for the tile envelope

mvtLayerParams - specifies vector tile properties

filter - geometry values that fail filter after transforms are removed

Returns:

tile geometry result

See Also:

TileGeomResult

createTileGeom

public static TileGeomResult createTileGeom(List<org.locationtech.jts.geom.Geometry> g,
                                            org.locationtech.jts.geom.Envelope tileEnvelope,
                                            org.locationtech.jts.geom.GeometryFactory geomFactory,
                                            MvtLayerParams mvtLayerParams,
                                            IGeometryFilter filter)

Create geometry clipped and then converted to MVT 'extent' coordinates. Result contains both clipped geometry (intersection) and transformed geometry for encoding to MVT.

Uses the same tile and clipping coordinates. May cause rendering issues on boundaries for polygons or line geometry depending on styling.

Parameters:

g - original 'source' geometry, passed through flatFeatureList(Geometry)

tileEnvelope - world coordinate bounds for tile

geomFactory - creates a geometry for the tile envelope

mvtLayerParams - specifies vector tile properties

filter - geometry values that fail filter after transforms are removed

Returns:

tile geometry result

See Also:

TileGeomResult

createTileGeom

public static TileGeomResult createTileGeom(List<org.locationtech.jts.geom.Geometry> g,
                                            org.locationtech.jts.geom.Envelope tileEnvelope,
                                            org.locationtech.jts.geom.Envelope clipEnvelope,
                                            org.locationtech.jts.geom.GeometryFactory geomFactory,
                                            MvtLayerParams mvtLayerParams,
                                            IGeometryFilter filter)

Create geometry clipped and then converted to MVT 'extent' coordinates. Result contains both clipped geometry (intersection) and transformed geometry for encoding to MVT.

Allows specifying separate tile and clipping coordinates. clipEnvelope can be bigger than tileEnvelope to have geometry exist outside the MVT tile extent.

Parameters:

g - original 'source' geometry, passed through flatFeatureList(Geometry)

tileEnvelope - world coordinate bounds for tile, used for transforms

clipEnvelope - world coordinates to clip tile by

geomFactory - creates a geometry for the tile envelope

mvtLayerParams - specifies vector tile properties

filter - geometry values that fail filter after transforms are removed

Returns:

tile geometry result

See Also:

TileGeomResult

toGeomType

public static VectorTile.Tile.GeomType toGeomType(org.locationtech.jts.geom.Geometry geometry)

Get the MVT type mapping for the provided JTS Geometry.

Parameters:

geometry - JTS Geometry to get MVT type for

Returns:

MVT type for the given JTS Geometry, may return VectorTile.Tile.GeomType#UNKNOWN

flatFeatureList

public static List<org.locationtech.jts.geom.Geometry> flatFeatureList(org.locationtech.jts.geom.Geometry geom)

Recursively convert a Geometry, which may be an instance of GeometryCollection with mixed element types, into a flat list containing only the following Geometry types:

• Point
• LineString
• Polygon
• MultiPoint
• MultiLineString
• MultiPolygon

WARNING: Any other Geometry types that were not mentioned in the list above will be discarded!

Useful for converting a generic geometry into a list of simple MVT-feature-ready geometries.

Parameters:

geom - geometry to flatten

Returns:

list of MVT-feature-ready geometries

toFeatures

public static List<VectorTile.Tile.Feature> toFeatures(org.locationtech.jts.geom.Geometry geometry,
                                                       MvtLayerProps layerProps,
                                                       IUserDataConverter userDataConverter)

Convert JTS Geometry to a list of vector tile features. The Geometry should be in MVT coordinates.

Each geometry will have its own ID.

Parameters:

geometry - JTS geometry to convert

layerProps - layer properties for tagging features

userDataConverter - convert Geometry.getUserData() to MVT feature tags

See Also:

flatFeatureList(Geometry), createTileGeom(Geometry, Envelope, GeometryFactory, MvtLayerParams, IGeometryFilter)

toFeatures

public static List<VectorTile.Tile.Feature> toFeatures(Collection<org.locationtech.jts.geom.Geometry> flatGeoms,
                                                       MvtLayerProps layerProps,
                                                       IUserDataConverter userDataConverter)

Convert a flat list of JTS Geometry to a list of vector tile features. The Geometry should be in MVT coordinates.

Each geometry will have its own ID.

Parameters:

flatGeoms - flat list of JTS geometry (in MVT coordinates) to convert

layerProps - layer properties for tagging features

userDataConverter - convert Geometry.getUserData() to MVT feature tags

See Also:

flatFeatureList(Geometry), createTileGeom(Geometry, Envelope, GeometryFactory, MvtLayerParams, IGeometryFilter)