org.n52.io.crs

Class CRSUtils

java.lang.Object

org.n52.io.crs.CRSUtils

public final class CRSUtils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected org.opengis.referencing.crs.CRSAuthorityFactory	crsFactory
static java.lang.String	DEFAULT_CRS Default is CRS:84 (EPSG:4326 with lon/lat ordering).
static int	EPSG_WGS84

Method Summary

Modifier and Type	Method and Description
static CRSUtils	createEpsgForcedXYAxisOrder() Creates a CRSUtils which offers assistance when doing spatial opererations.
static CRSUtils	createEpsgReferenceHelper(org.geotools.util.factory.Hints hints) Creates a CRSUtils which offers assistance when doing spatial opererations.
static CRSUtils	createEpsgStrictAxisOrder() Creates an CRSUtils which offers assistance when doing spatial opererations.
org.locationtech.jts.geom.GeometryFactory	createGeometryFactory()
org.locationtech.jts.geom.GeometryFactory	createGeometryFactory(java.lang.String srsId)
org.locationtech.jts.geom.Geometry	createLineString(org.locationtech.jts.geom.Coordinate[] coordinates, java.lang.String srs)
org.locationtech.jts.geom.Point	createPoint(java.lang.Double x, java.lang.Double y, java.lang.Double z, java.lang.String srs) Creates a 2D point geometry with respect to its height and given reference system.
org.locationtech.jts.geom.Point	createPoint(java.lang.Double x, java.lang.Double y, java.lang.String srs) Creates a 2D point geometry within the given reference system.
static java.lang.String	extractSRSCode(java.lang.String srs)
static int	getSrsIdFrom(java.lang.String srs) Extracts the SRS number of the incoming SRS definition string.
static int	getSrsIdFromEPSG(java.lang.String srs)
boolean	isLatLonAxesOrder(java.lang.String outer) Indicates if the given reference frame has switched axes compared to the inner default (lon/lat).
org.locationtech.jts.geom.Geometry	parseWkt(java.lang.String wkt)
org.locationtech.jts.geom.Geometry	transform(org.locationtech.jts.geom.Geometry geometry, java.lang.String srcFrame, java.lang.String destFrame) Transforms a given geometry from a given reference to a destinated reference.
org.locationtech.jts.geom.Geometry	transformInnerToOuter(org.locationtech.jts.geom.Geometry geometry, java.lang.String destFrame) Transforms a given geometry from its inner reference (which is WGS84 (CRS:84)) to a given reference.
org.locationtech.jts.geom.Geometry	transformOuterToInner(org.locationtech.jts.geom.Geometry geometry, java.lang.String srcFrame) Transforms a given geometry from a given reference to inner reference, which is WGS84 (CRS:84).
org.locationtech.jts.geom.Point	transformOuterToInner(org.locationtech.jts.geom.Point point, java.lang.String srcFrame) Transforms a given point from a given reference to inner reference, which is WGS84 (CRS:84).

Methods inherited from class java.lang.Object

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

Field Detail

EPSG_WGS84

public static final int EPSG_WGS84

See Also:

Constant Field Values

DEFAULT_CRS

public static final java.lang.String DEFAULT_CRS

Default is CRS:84 (EPSG:4326 with lon/lat ordering).

See Also:

Constant Field Values

crsFactory

protected org.opengis.referencing.crs.CRSAuthorityFactory crsFactory

Method Detail

createPoint

public org.locationtech.jts.geom.Point createPoint(java.lang.Double x,
                                                   java.lang.Double y,
                                                   java.lang.String srs)

Creates a 2D point geometry within the given reference system.

Parameters:

x - the coordinate's x value.

y - the coordinate's y value.

srs - an authoritive spatial reference system code, e.g. EPSG:4326 or CRS:84 .

Returns:

a point referenced by the given spatial reference system.

createPoint

public org.locationtech.jts.geom.Point createPoint(java.lang.Double x,
                                                   java.lang.Double y,
                                                   java.lang.Double z,
                                                   java.lang.String srs)

Creates a 2D point geometry with respect to its height and given reference system.

Parameters:

x - the point's x value.

y - the point's y value.

z - the height or null or NaN if coordinate is 2D.

srs - an authoritive spatial reference system code, e.g. EPSG:4326 or CRS:84 .

Returns:

a point referenced by the given spatial reference system.

createLineString

public org.locationtech.jts.geom.Geometry createLineString(org.locationtech.jts.geom.Coordinate[] coordinates,
                                                           java.lang.String srs)

createGeometryFactory

public org.locationtech.jts.geom.GeometryFactory createGeometryFactory()

createGeometryFactory

public org.locationtech.jts.geom.GeometryFactory createGeometryFactory(java.lang.String srsId)

getSrsIdFrom

public static int getSrsIdFrom(java.lang.String srs)

Extracts the SRS number of the incoming SRS definition string. This can be either an HTTP URL (like http://www.opengis.net/def/crs/EPSG/0/4326) or a URN (like urn:ogc:def:crs:EPSG::31466).

Parameters:

srs - the SRS definition string, either as URL ('/'-separated) or as URN (': '-separated).

Returns:

the SRS number, e.g. 4326

extractSRSCode

public static java.lang.String extractSRSCode(java.lang.String srs)

Parameters:

srs - the SRS definition string, either as URL ('/'-separated) or as URN (': '-separated).

Returns:

SRS string in the form of for example 'EPSG:4326' or 'EPSG:31466'.

getSrsIdFromEPSG

public static int getSrsIdFromEPSG(java.lang.String srs)

transformOuterToInner

public org.locationtech.jts.geom.Point transformOuterToInner(org.locationtech.jts.geom.Point point,
                                                             java.lang.String srcFrame)
                                                      throws org.opengis.referencing.FactoryException,
                                                             org.opengis.referencing.operation.TransformException

Transforms a given point from a given reference to inner reference, which is WGS84 (CRS:84).

Parameters:

point - the point to transform.

srcFrame - the CRS authority code the given point is referenced in.

Returns:

a point referenced in WGS84

Throws:

org.opengis.referencing.FactoryException - if the creation of CoordinateReferenceSystem fails or no appropriate MathTransform could be created

org.opengis.referencing.operation.TransformException - if transformation fails for any other reason

transformOuterToInner

public org.locationtech.jts.geom.Geometry transformOuterToInner(org.locationtech.jts.geom.Geometry geometry,
                                                                java.lang.String srcFrame)
                                                         throws org.opengis.referencing.FactoryException,
                                                                org.opengis.referencing.operation.TransformException

Transforms a given geometry from a given reference to inner reference, which is WGS84 (CRS:84).

Parameters:

geometry - the geometry to transform.

srcFrame - the CRS authority code the given point is referenced in.

Returns:

a geometry referenced in WGS84

Throws:

org.opengis.referencing.FactoryException - if the creation of CoordinateReferenceSystem fails or no appropriate MathTransform could be created.

org.opengis.referencing.operation.TransformException - if transformation fails for any other reason.

transformInnerToOuter

public org.locationtech.jts.geom.Geometry transformInnerToOuter(org.locationtech.jts.geom.Geometry geometry,
                                                                java.lang.String destFrame)
                                                         throws org.opengis.referencing.FactoryException,
                                                                org.opengis.referencing.operation.TransformException

Transforms a given geometry from its inner reference (which is WGS84 (CRS:84)) to a given reference.

Parameters:

geometry - the geometry to transform.

destFrame - the CRS authority code the given point shall be transformed to.

Returns:

a transformed geometry with dest reference.

Throws:

org.opengis.referencing.FactoryException - if the creation of CoordinateReferenceSystem fails or no appropriate MathTransform could be created.

org.opengis.referencing.operation.TransformException - if transformation fails for any other reason.

transform

public org.locationtech.jts.geom.Geometry transform(org.locationtech.jts.geom.Geometry geometry,
                                                    java.lang.String srcFrame,
                                                    java.lang.String destFrame)
                                             throws org.opengis.referencing.FactoryException,
                                                    org.opengis.referencing.operation.TransformException

Transforms a given geometry from a given reference to a destinated reference.

Parameters:

geometry - the geometry to transform.

srcFrame - the reference the given point is in.

destFrame - the reference frame the point shall be transformed to.

Returns:

a transformed point.

Throws:

org.opengis.referencing.FactoryException - if the creation of CoordinateReferenceSystem fails or no appropriate MathTransform could be created.

org.opengis.referencing.operation.TransformException - if transformation fails for any other reason.

parseWkt

public org.locationtech.jts.geom.Geometry parseWkt(java.lang.String wkt)

isLatLonAxesOrder

public boolean isLatLonAxesOrder(java.lang.String outer)
                          throws org.opengis.referencing.FactoryException

Indicates if the given reference frame has switched axes compared to the inner default (lon/lat).

Parameters:

outer - the given reference frame code to check.

Returns:

true if axes order is switched compared to the inner default.

Throws:

org.opengis.referencing.FactoryException - if no proper CRS could be created.

createEpsgStrictAxisOrder

public static CRSUtils createEpsgStrictAxisOrder()

Creates an CRSUtils which offers assistance when doing spatial opererations. Strict means that all CRS defined with lat/lon axis ordering will be handled as defined.

Returns:

creates a reference helper which (strictly) handles referencing operations.

Throws:

java.lang.IllegalStateException - if decoding default CRS fails.

createEpsgForcedXYAxisOrder

public static CRSUtils createEpsgForcedXYAxisOrder()

Creates a CRSUtils which offers assistance when doing spatial opererations. Forcing XY means that CRS axis ordering is considered lon/lat ordering, even if defined lat/lon.

Returns:

creates a reference helper which (strictly) handles referencing operations.

Throws:

java.lang.IllegalStateException - if decoding default CRS fails.

createEpsgReferenceHelper

public static CRSUtils createEpsgReferenceHelper(org.geotools.util.factory.Hints hints)
                                          throws java.lang.IllegalStateException

Creates a CRSUtils which offers assistance when doing spatial opererations.

Parameters:

hints - Some Geotools Hints which set behavior and special considerations regarding to the spatial operations.

Returns:

an instance of CRSUtils using given hints

Throws:

java.lang.IllegalStateException