com.axiomalaska.spatial

Class SpatialUtil

java.lang.Object

com.axiomalaska.spatial.SpatialUtil

public class SpatialUtil
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static int	AK_ALBERS_EPSG
static com.vividsolutions.jts.geom.LineString	BOTTOM_EDGE_4326
static com.vividsolutions.jts.geom.Polygon	DENSIFIED_EASTERN_4326_POLYGON
static com.vividsolutions.jts.geom.Polygon	DENSIFIED_WESTERN_4326_POLYGON
static com.vividsolutions.jts.geom.Polygon	EASTERN_4326_POLYGON
static com.vividsolutions.jts.geom.Polygon	GLOBAL_EXTENT_POLYGON
static com.vividsolutions.jts.geom.LineString	MERIDIAN_4326
static com.vividsolutions.jts.geom.LineString	NEGATIVE_ANTIMERIDIAN_4326
static Collection<Integer>	NON_DENSIFY_SRIDS
static com.vividsolutions.jts.geom.Point	NORTH_POLE_3572
static com.vividsolutions.jts.geom.Polygon	NORTHERN_HEMISPHERE_POLYGON
static int	POLAR_ALASKA_EPSG
static Collection<Integer>	POLAR_SRIDS
static com.vividsolutions.jts.geom.LineString	POSITIVE_ANTIMERIDIAN_4326
static com.vividsolutions.jts.geom.LineString	TOP_EDGE_4326
static AtomicInteger	topologyExceptionCount
static int	WEB_MERCATOR_EPSG
static com.vividsolutions.jts.geom.Polygon	WESTERN_4326_POLYGON
static int	WGS84_EPSG

Method Summary

Modifier and Type	Method and Description
static com.vividsolutions.jts.geom.Geometry	clipToAreaOfValidity(com.vividsolutions.jts.geom.Geometry geometry, int targetEpsg)
static com.vividsolutions.jts.geom.LinearRing	closeLineString(com.vividsolutions.jts.geom.GeometryFactory geomFactory, com.vividsolutions.jts.geom.LineString lineString)
static com.vividsolutions.jts.geom.Point	createPointLngLat(double lng, double lat)
static com.vividsolutions.jts.geom.Coordinate	forceLongitudeNegative(com.vividsolutions.jts.geom.Coordinate coord) Clone a coordinate and force longitude to negative
static com.vividsolutions.jts.geom.Coordinate	forceLongitudeNegative(com.vividsolutions.jts.geom.Coordinate coord, boolean cloneCoordinate)
static com.vividsolutions.jts.geom.Geometry	forceLongitudeNegative(com.vividsolutions.jts.geom.Geometry geometry)
static com.vividsolutions.jts.geom.Coordinate	forceLongitudePositive(com.vividsolutions.jts.geom.Coordinate coord) Clone a coordinate and force longitude to positive
static com.vividsolutions.jts.geom.Coordinate	forceLongitudePositive(com.vividsolutions.jts.geom.Coordinate coord, boolean cloneCoordinate)
static com.vividsolutions.jts.geom.Geometry	forceLongitudePositive(com.vividsolutions.jts.geom.Geometry geometry)
static com.vividsolutions.jts.geom.Geometry	get4326SafePolygon(com.vividsolutions.jts.geom.Polygon sourcePolygon)
static com.vividsolutions.jts.geom.Geometry	get4326SafePolygon(com.vividsolutions.jts.geom.Polygon sourcePolygon, int lengthSimplificationFactor, boolean fix4326Polygons) Transform a polygon into 4326, splitting along the antimeridian if necessary.
static com.vividsolutions.jts.geom.Geometry	getExtentGeom(com.vividsolutions.jts.geom.Geometry geom)
static com.vividsolutions.jts.geom.Polygon	getExtentPolygon(int srid, double minX, double minY, double maxX, double maxY)
static com.vividsolutions.jts.geom.Polygon	getExtentPolygonFromLatLngs(double minLng, double minLat, double maxLng, double maxLat)
static com.vividsolutions.jts.geom.GeometryFactory	getGeometryFactory(int srid)
static com.vividsolutions.jts.geom.LineString	getLineString(int srid, double x1, double y1, double x2, double y2)
static com.vividsolutions.jts.geom.Point	getPoint(int srid, double x, double y)
static com.vividsolutions.jts.geom.Coordinate	getPositiveAntimeridianIntersectionPoint(com.vividsolutions.jts.geom.Coordinate coord1, com.vividsolutions.jts.geom.Coordinate coord2)
static com.vividsolutions.jts.geom.Coordinate	normalizeLongitude(com.vividsolutions.jts.geom.Coordinate coord)
static com.vividsolutions.jts.geom.Coordinate	normalizeLongitude(com.vividsolutions.jts.geom.Coordinate coord, boolean cloneCoordinate) Clone coordinate and force its longitude back into -180 to 180 range
static com.vividsolutions.jts.geom.Geometry	normalizeLongitude(com.vividsolutions.jts.geom.Geometry geometry)
static com.vividsolutions.jts.geom.Geometry	parseEWKT(String ewkt)
static com.vividsolutions.jts.geom.Geometry	processPolygons(List<com.vividsolutions.jts.geom.Polygon> polygons)
static List<com.vividsolutions.jts.geom.Polygon>	split4326AntimeridianStraddlingPolygon(com.vividsolutions.jts.geom.Geometry geometry, int lengthSimplificationFactor)
static com.vividsolutions.jts.geom.Geometry	splitPolygon(com.vividsolutions.jts.geom.Geometry sourcePolygon, com.vividsolutions.jts.geom.LineString splitLine) Split a polygon with a line.
static String	toEWKT(com.vividsolutions.jts.geom.Geometry geom)
static com.vividsolutions.jts.geom.Geometry	transformExtentGeometry(com.vividsolutions.jts.geom.Geometry geometry, int toEpsg)
static com.vividsolutions.jts.geom.Geometry	transformGeometry(com.vividsolutions.jts.geom.Geometry geometry, int toEpsg)
static com.vividsolutions.jts.geom.Geometry	transformGeometry(com.vividsolutions.jts.geom.Geometry geometry, int toEpsg, int densifyFactor, boolean clipToValidArea)

Methods inherited from class java.lang.Object

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

Field Detail

topologyExceptionCount

public static AtomicInteger topologyExceptionCount

WGS84_EPSG

public static final int WGS84_EPSG

See Also:

Constant Field Values

AK_ALBERS_EPSG

public static final int AK_ALBERS_EPSG

See Also:

Constant Field Values

POLAR_ALASKA_EPSG

public static final int POLAR_ALASKA_EPSG

See Also:

Constant Field Values

WEB_MERCATOR_EPSG

public static final int WEB_MERCATOR_EPSG

See Also:

Constant Field Values

GLOBAL_EXTENT_POLYGON

public static final com.vividsolutions.jts.geom.Polygon GLOBAL_EXTENT_POLYGON

NORTHERN_HEMISPHERE_POLYGON

public static final com.vividsolutions.jts.geom.Polygon NORTHERN_HEMISPHERE_POLYGON

WESTERN_4326_POLYGON

public static final com.vividsolutions.jts.geom.Polygon WESTERN_4326_POLYGON

EASTERN_4326_POLYGON

public static final com.vividsolutions.jts.geom.Polygon EASTERN_4326_POLYGON

DENSIFIED_WESTERN_4326_POLYGON

public static final com.vividsolutions.jts.geom.Polygon DENSIFIED_WESTERN_4326_POLYGON

DENSIFIED_EASTERN_4326_POLYGON

public static final com.vividsolutions.jts.geom.Polygon DENSIFIED_EASTERN_4326_POLYGON

MERIDIAN_4326

public static final com.vividsolutions.jts.geom.LineString MERIDIAN_4326

NEGATIVE_ANTIMERIDIAN_4326

public static final com.vividsolutions.jts.geom.LineString NEGATIVE_ANTIMERIDIAN_4326

POSITIVE_ANTIMERIDIAN_4326

public static final com.vividsolutions.jts.geom.LineString POSITIVE_ANTIMERIDIAN_4326

TOP_EDGE_4326

public static final com.vividsolutions.jts.geom.LineString TOP_EDGE_4326

BOTTOM_EDGE_4326

public static final com.vividsolutions.jts.geom.LineString BOTTOM_EDGE_4326

NORTH_POLE_3572

public static final com.vividsolutions.jts.geom.Point NORTH_POLE_3572

NON_DENSIFY_SRIDS

public static final Collection<Integer> NON_DENSIFY_SRIDS

POLAR_SRIDS

public static final Collection<Integer> POLAR_SRIDS

Method Detail

getGeometryFactory

public static com.vividsolutions.jts.geom.GeometryFactory getGeometryFactory(int srid)

getPoint

public static com.vividsolutions.jts.geom.Point getPoint(int srid,
                                                         double x,
                                                         double y)

getLineString

public static com.vividsolutions.jts.geom.LineString getLineString(int srid,
                                                                   double x1,
                                                                   double y1,
                                                                   double x2,
                                                                   double y2)

getExtentPolygonFromLatLngs

public static com.vividsolutions.jts.geom.Polygon getExtentPolygonFromLatLngs(double minLng,
                                                                              double minLat,
                                                                              double maxLng,
                                                                              double maxLat)
                                                                       throws org.opengis.geometry.MismatchedDimensionException,
                                                                              org.opengis.referencing.operation.TransformException,
                                                                              org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                              org.opengis.referencing.FactoryException

Throws:

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.operation.TransformException

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

getExtentPolygon

public static com.vividsolutions.jts.geom.Polygon getExtentPolygon(int srid,
                                                                   double minX,
                                                                   double minY,
                                                                   double maxX,
                                                                   double maxY)

transformGeometry

public static com.vividsolutions.jts.geom.Geometry transformGeometry(com.vividsolutions.jts.geom.Geometry geometry,
                                                                     int toEpsg)
                                                              throws org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                     org.opengis.referencing.FactoryException,
                                                                     org.opengis.geometry.MismatchedDimensionException,
                                                                     org.opengis.referencing.operation.TransformException

Throws:

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.operation.TransformException

transformGeometry

public static com.vividsolutions.jts.geom.Geometry transformGeometry(com.vividsolutions.jts.geom.Geometry geometry,
                                                                     int toEpsg,
                                                                     int densifyFactor,
                                                                     boolean clipToValidArea)
                                                              throws org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                     org.opengis.referencing.FactoryException,
                                                                     org.opengis.geometry.MismatchedDimensionException,
                                                                     org.opengis.referencing.operation.TransformException

Throws:

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.operation.TransformException

clipToAreaOfValidity

public static com.vividsolutions.jts.geom.Geometry clipToAreaOfValidity(com.vividsolutions.jts.geom.Geometry geometry,
                                                                        int targetEpsg)
                                                                 throws org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                        org.opengis.referencing.FactoryException,
                                                                        org.opengis.geometry.MismatchedDimensionException,
                                                                        org.opengis.referencing.operation.TransformException

Throws:

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.operation.TransformException

getExtentGeom

public static com.vividsolutions.jts.geom.Geometry getExtentGeom(com.vividsolutions.jts.geom.Geometry geom)

transformExtentGeometry

public static com.vividsolutions.jts.geom.Geometry transformExtentGeometry(com.vividsolutions.jts.geom.Geometry geometry,
                                                                           int toEpsg)
                                                                    throws org.opengis.geometry.MismatchedDimensionException,
                                                                           org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                           org.opengis.referencing.FactoryException,
                                                                           org.opengis.referencing.operation.TransformException

Throws:

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

org.opengis.referencing.operation.TransformException

parseEWKT

public static com.vividsolutions.jts.geom.Geometry parseEWKT(String ewkt)
                                                      throws com.vividsolutions.jts.io.ParseException

Throws:

com.vividsolutions.jts.io.ParseException

toEWKT

public static String toEWKT(com.vividsolutions.jts.geom.Geometry geom)

createPointLngLat

public static com.vividsolutions.jts.geom.Point createPointLngLat(double lng,
                                                                  double lat)

splitPolygon

public static com.vividsolutions.jts.geom.Geometry splitPolygon(com.vividsolutions.jts.geom.Geometry sourcePolygon,
                                                                com.vividsolutions.jts.geom.LineString splitLine)
                                                         throws org.opengis.geometry.MismatchedDimensionException,
                                                                org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                org.opengis.referencing.FactoryException,
                                                                org.opengis.referencing.operation.TransformException

Split a polygon with a line. Heavy borrowing from here: https://code.google.com/p/geoadminsuite/source/browse/branches/src/org/kaboum/server/topology/JTSCutPolygonByLineAction.java?r=217 and here http://trac.osgeo.org/postgis/wiki/UsersWikiSplitPolygonWithLineString

Parameters:

sourcePolygon - The polygon to be split

splitLine - The line to split with

Returns:

Either the original polygon if it doesn't intersect the split line, or a split multipolygon

Throws:

org.opengis.referencing.operation.TransformException

org.opengis.referencing.FactoryException

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.geometry.MismatchedDimensionException

closeLineString

public static final com.vividsolutions.jts.geom.LinearRing closeLineString(com.vividsolutions.jts.geom.GeometryFactory geomFactory,
                                                                           com.vividsolutions.jts.geom.LineString lineString)

getPositiveAntimeridianIntersectionPoint

public static com.vividsolutions.jts.geom.Coordinate getPositiveAntimeridianIntersectionPoint(com.vividsolutions.jts.geom.Coordinate coord1,
                                                                                              com.vividsolutions.jts.geom.Coordinate coord2)

normalizeLongitude

public static com.vividsolutions.jts.geom.Coordinate normalizeLongitude(com.vividsolutions.jts.geom.Coordinate coord)

normalizeLongitude

public static com.vividsolutions.jts.geom.Coordinate normalizeLongitude(com.vividsolutions.jts.geom.Coordinate coord,
                                                                        boolean cloneCoordinate)

Clone coordinate and force its longitude back into -180 to 180 range

Parameters:

coord - Coordinate to clone and force to normal range

Returns:

Cloned and normalized range forced coordinate

normalizeLongitude

public static com.vividsolutions.jts.geom.Geometry normalizeLongitude(com.vividsolutions.jts.geom.Geometry geometry)

forceLongitudePositive

public static com.vividsolutions.jts.geom.Geometry forceLongitudePositive(com.vividsolutions.jts.geom.Geometry geometry)

forceLongitudePositive

public static com.vividsolutions.jts.geom.Coordinate forceLongitudePositive(com.vividsolutions.jts.geom.Coordinate coord)

Clone a coordinate and force longitude to positive

Parameters:

coord - Coordinate to clone and force to positive

Returns:

Cloned and positive longitude forced coordinate

forceLongitudePositive

public static com.vividsolutions.jts.geom.Coordinate forceLongitudePositive(com.vividsolutions.jts.geom.Coordinate coord,
                                                                            boolean cloneCoordinate)

forceLongitudeNegative

public static com.vividsolutions.jts.geom.Geometry forceLongitudeNegative(com.vividsolutions.jts.geom.Geometry geometry)

forceLongitudeNegative

public static com.vividsolutions.jts.geom.Coordinate forceLongitudeNegative(com.vividsolutions.jts.geom.Coordinate coord)

Clone a coordinate and force longitude to negative

Parameters:

coord - Coordinate to clone and force to negative

Returns:

Cloned and negative longitude forced coordinate

forceLongitudeNegative

public static com.vividsolutions.jts.geom.Coordinate forceLongitudeNegative(com.vividsolutions.jts.geom.Coordinate coord,
                                                                            boolean cloneCoordinate)

get4326SafePolygon

public static com.vividsolutions.jts.geom.Geometry get4326SafePolygon(com.vividsolutions.jts.geom.Polygon sourcePolygon)
                                                               throws org.opengis.geometry.MismatchedDimensionException,
                                                                      org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                      org.opengis.referencing.FactoryException,
                                                                      org.opengis.referencing.operation.TransformException

Throws:

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

org.opengis.referencing.operation.TransformException

get4326SafePolygon

public static com.vividsolutions.jts.geom.Geometry get4326SafePolygon(com.vividsolutions.jts.geom.Polygon sourcePolygon,
                                                                      int lengthSimplificationFactor,
                                                                      boolean fix4326Polygons)
                                                               throws org.opengis.geometry.MismatchedDimensionException,
                                                                      org.opengis.referencing.NoSuchAuthorityCodeException,
                                                                      org.opengis.referencing.FactoryException,
                                                                      org.opengis.referencing.operation.TransformException

Transform a polygon into 4326, splitting along the antimeridian if necessary. If split, the result will be a MultiPolygon, otherwise it will be a Polygon.

Parameters:

sourcePolygon - The polygon to transform to 4326 and possibly split along the antimeridian.

lengthSimplificationFactor - Factor by which to simplify the resulting polygon, which will have been densified during the transformation. Try something around 300.

fix4326Polygons - Whether to fix 4326 polygons (split by antimeridian if needed) or return unchanged

Returns:

The 4326 transformed and possibly split polygon

Throws:

org.opengis.geometry.MismatchedDimensionException

org.opengis.referencing.NoSuchAuthorityCodeException

org.opengis.referencing.FactoryException

org.opengis.referencing.operation.TransformException

split4326AntimeridianStraddlingPolygon

public static List<com.vividsolutions.jts.geom.Polygon> split4326AntimeridianStraddlingPolygon(com.vividsolutions.jts.geom.Geometry geometry,
                                                                                               int lengthSimplificationFactor)

processPolygons

public static com.vividsolutions.jts.geom.Geometry processPolygons(List<com.vividsolutions.jts.geom.Polygon> polygons)