Package org.codice.ddf.libs.geo.util

Class GeospatialUtil

java.lang.Object

org.codice.ddf.libs.geo.util.GeospatialUtil

public class GeospatialUtil
extends Object

Convenience methods for performing geospatial conversions.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	EPSG_4326
static final String	EPSG_4326_URN
static final String	LAT_LON_ORDER
static final String	LON_LAT_ORDER

Method Summary

Modifier and Type	Method	Description
static org.locationtech.jts.geom.Geometry	createCirclePolygon(double lat, double lon, double radius, int maxVertices, double distanceTolerance)	Create a circular polygon from a lat, lon, radius, vertices, and distanceTolerance.
static Double	parseDMSLatitudeWithDecimalSeconds(String dmsLat)	Parses Latitude in the DMS format of DD:MM:SS.S N/S
static Double	parseDMSLongitudeWithDecimalSeconds(String dmsLon)	Parses Longitude in the DMS format of [D]DD:MM:SS.S E/W
static org.locationtech.jts.geom.Geometry	transformToEPSG4326LonLatFormat(org.locationtech.jts.geom.Geometry geometry, String sourceCrsName)	Transform a geometry to EPSG:4326 format with lon/lat coordinate ordering.
static org.locationtech.jts.geom.Geometry	transformToEPSG4326LonLatFormat(org.locationtech.jts.geom.Geometry geometry, org.geotools.api.referencing.crs.CoordinateReferenceSystem sourceCrs)	Transform a geometry to EPSG:4326 format with lon/lat coordinate ordering.

Methods inherited from class java.lang.Object

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

Field Details

EPSG_4326

public static final String EPSG_4326

See Also:

• Constant Field Values

EPSG_4326_URN

public static final String EPSG_4326_URN

See Also:

• Constant Field Values

LAT_LON_ORDER

public static final String LAT_LON_ORDER

See Also:

• Constant Field Values

LON_LAT_ORDER

public static final String LON_LAT_ORDER

See Also:

• Constant Field Values

Method Details

parseDMSLatitudeWithDecimalSeconds

public static Double parseDMSLatitudeWithDecimalSeconds(String dmsLat)
                                                 throws GeoFormatException

Parses Latitude in the DMS format of DD:MM:SS.S N/S

Parameters:

dmsLat - Degrees Minutes Seconds formatted latitude.

Returns:

Latitude in decimal degrees

Throws:

GeoFormatException

parseDMSLongitudeWithDecimalSeconds

public static Double parseDMSLongitudeWithDecimalSeconds(String dmsLon)
                                                  throws GeoFormatException

Parses Longitude in the DMS format of [D]DD:MM:SS.S E/W

Parameters:

dmsLon - Degrees Minutes Seconds formatted longitude.

Returns:

Longitude in decimal degrees.

Throws:

GeoFormatException

transformToEPSG4326LonLatFormat

public static org.locationtech.jts.geom.Geometry transformToEPSG4326LonLatFormat(org.locationtech.jts.geom.Geometry geometry,
 String sourceCrsName)
                                                                          throws GeoFormatException

Transform a geometry to EPSG:4326 format with lon/lat coordinate ordering. NOTE: This method will perform the transform swapping coordinates even if the sourceCrsName is EPSG:4326

Parameters:

geometry - - Geometry to transform

sourceCrsName - - Source geometry's coordinate reference system

Returns:

Geometry - Transformed geometry into EPSG:4326 lon/lat coordinate system

Throws:

GeoFormatException

transformToEPSG4326LonLatFormat

public static org.locationtech.jts.geom.Geometry transformToEPSG4326LonLatFormat(org.locationtech.jts.geom.Geometry geometry,
 org.geotools.api.referencing.crs.CoordinateReferenceSystem sourceCrs)
                                                                          throws GeoFormatException

Transform a geometry to EPSG:4326 format with lon/lat coordinate ordering. NOTE: This method will NOT perform the transform swapping coordinates even if the sourceCrsName is EPSG:4326.

Parameters:

geometry - - Geometry to transform

sourceCrs - - Source geometry's coordinate reference system

Returns:

Geometry - Transformed geometry into EPSG:4326 lon/lat coordinate system

Throws:

GeoFormatException

createCirclePolygon

public static org.locationtech.jts.geom.Geometry createCirclePolygon(double lat,
 double lon,
 double radius,
 int maxVertices,
 double distanceTolerance)

Create a circular polygon from a lat, lon, radius, vertices, and distanceTolerance.

Parameters:

lat - - latitude in EPSG:4326 decimal degrees

lon - - longitude in EPSG:4326 decimal degrees

Returns:

radius - distance from the center point in meters