org.geomajas.service

Interface GeoService

@Api(allMethods=true)
public interface GeoService

Collection of utility functions concerning geometries.

Since:

1.6.0

Author:

Joachim Van der Auwera

Method Summary

Methods

Modifier and Type	Method and Description
com.vividsolutions.jts.geom.Coordinate	calcDefaultLabelPosition(InternalFeature feature) Determine a default position for positioning the label for a feature.
com.vividsolutions.jts.geom.Geometry	createCircle(com.vividsolutions.jts.geom.Point center, double radius, int nrPoints) Create a geometry which approximates like a circle.
MathTransform	findMathTransform(CoordinateReferenceSystem sourceCrs, CoordinateReferenceSystem targetCrs) Get the transformation which converts between two coordinate systems.
String	getCodeFromCrs(CoordinateReferenceSystem crs) Try to extract the code from the CRS.
String	getCodeFromCrs(Crs crs) Get the code from the CRS.
CoordinateReferenceSystem	getCrs(String crs) Deprecated. use getCrs2()
Crs	getCrs2(String crs) Get the Crs with given code.
CrsTransform	getCrsTransform(CoordinateReferenceSystem sourceCrs, CoordinateReferenceSystem targetCrs) Get the transformation which converts between two coordinate systems.
CrsTransform	getCrsTransform(Crs sourceCrs, Crs targetCrs) Get the transformation which converts between two coordinate systems.
CrsTransform	getCrsTransform(String sourceCrs, String targetCrs) Get the transformation which converts between two coordinate systems.
int	getSridFromCrs(CoordinateReferenceSystem crs) Try to extract the SRID (Spatial Reference Id) from the CRS.
int	getSridFromCrs(String crs) Try to extract the SRID (Spatial Reference Id) from the CRS.
org.geomajas.geometry.Bbox	transform(org.geomajas.geometry.Bbox source, Crs sourceCrs, Crs targetCrs) Transform a Bbox from the source to the target CRS.
org.geomajas.geometry.Bbox	transform(org.geomajas.geometry.Bbox source, CrsTransform crsTransform) Transform a Bbox using the given transformation.
org.geomajas.geometry.Bbox	transform(org.geomajas.geometry.Bbox source, String sourceCrs, String targetCrs) Transform a Bbox from the source to the target CRS.
com.vividsolutions.jts.geom.Coordinate	transform(com.vividsolutions.jts.geom.Coordinate source, Crs sourceCrs, Crs targetCrs) Transform a Coordinate from the source to the target CRS.
com.vividsolutions.jts.geom.Coordinate	transform(com.vividsolutions.jts.geom.Coordinate source, CrsTransform crsTransform) Transform a Coordinate using the given transformation.
com.vividsolutions.jts.geom.Coordinate	transform(com.vividsolutions.jts.geom.Coordinate source, String sourceCrs, String targetCrs) Transform a Coordinate from the source to the target CRS.
com.vividsolutions.jts.geom.Envelope	transform(com.vividsolutions.jts.geom.Envelope source, Crs sourceCrs, Crs targetCrs) Transform a Envelope from the source to the target CRS.
com.vividsolutions.jts.geom.Envelope	transform(com.vividsolutions.jts.geom.Envelope source, CrsTransform crsTransform) Transform a Envelope using the given transformation.
com.vividsolutions.jts.geom.Envelope	transform(com.vividsolutions.jts.geom.Envelope source, String sourceCrs, String targetCrs) Transform a Envelope from the source to the target CRS.
com.vividsolutions.jts.geom.Geometry	transform(com.vividsolutions.jts.geom.Geometry source, CoordinateReferenceSystem sourceCrs, CoordinateReferenceSystem targetCrs) Deprecated. use transform(Geometry, Crs, Crs) instead
com.vividsolutions.jts.geom.Geometry	transform(com.vividsolutions.jts.geom.Geometry source, Crs sourceCrs, Crs targetCrs) Transform a Geometry from the source to the target CRS.
com.vividsolutions.jts.geom.Geometry	transform(com.vividsolutions.jts.geom.Geometry source, CrsTransform crsTransform) Transform a Geometry using the given transformation.
com.vividsolutions.jts.geom.Geometry	transform(com.vividsolutions.jts.geom.Geometry source, String sourceCrs, String targetCrs) Transform a Geometry from the source to the target CRS.

Method Detail

getCrs

@Deprecated
CoordinateReferenceSystem getCrs(String crs)
                                 throws LayerException

Deprecated. use getCrs2()

Get the CoordinateReferenceSystem with given code.

Parameters:

crs - Coordinate reference system code. (EPSG:xxxx)

Returns:

CoordinateReferenceSystem

Throws:

LayerException - CRS code not found

Since:

1.7.0

getCrs2

Crs getCrs2(String crs)
            throws LayerException

Get the Crs with given code.

Parameters:

crs - Coordinate reference system code. (EPSG:xxxx)

Returns:

CoordinateReferenceSystem

Throws:

LayerException - CRS code not found

Since:

1.8.0

getSridFromCrs

int getSridFromCrs(String crs)

Try to extract the SRID (Spatial Reference Id) from the CRS. Unreliable but works if SRIDs are same as EPSG numbers.

Parameters:

crs - CRS string in the form of 'EPSG:'.

Returns:

SRID as integer.

getSridFromCrs

int getSridFromCrs(CoordinateReferenceSystem crs)

Try to extract the SRID (Spatial Reference Id) from the CRS. Unreliable but works if SRIDs are same as EPSG numbers.

Parameters:

crs - reference system of EPSG type.

Returns:

SRID as integer.

getCodeFromCrs

String getCodeFromCrs(CoordinateReferenceSystem crs)

Try to extract the code from the CRS. Uses the actual code in case of a Crs or best guess based on the srid code otherwise.

Parameters:

crs - reference system of EPSG type

Returns:

CRS code

Since:

1.8.0

getCodeFromCrs

String getCodeFromCrs(Crs crs)

Get the code from the CRS.

Parameters:

crs - reference system of EPSG type.

Returns:

CRS code

Since:

1.8.0

findMathTransform

MathTransform findMathTransform(CoordinateReferenceSystem sourceCrs,
                              CoordinateReferenceSystem targetCrs)
                                throws GeomajasException

Get the transformation which converts between two coordinate systems.

Parameters:

sourceCrs - crs used by source data

targetCrs - crs to be used by target

Returns:

transformation matrix

Throws:

GeomajasException - building the transformation is not possible

getCrsTransform

CrsTransform getCrsTransform(Crs sourceCrs,
                           Crs targetCrs)
                             throws GeomajasException

Get the transformation which converts between two coordinate systems.

Parameters:

sourceCrs - crs used by source data

targetCrs - crs to be used by target

Returns:

transformation matrix

Throws:

GeomajasException - building the transformation is not possible

Since:

1.8.0

getCrsTransform

CrsTransform getCrsTransform(CoordinateReferenceSystem sourceCrs,
                           CoordinateReferenceSystem targetCrs)
                             throws GeomajasException

Get the transformation which converts between two coordinate systems.

Parameters:

sourceCrs - crs used by source data

targetCrs - crs to be used by target

Returns:

transformation matrix

Throws:

GeomajasException - building the transformation is not possible

Since:

1.8.0

getCrsTransform

CrsTransform getCrsTransform(String sourceCrs,
                           String targetCrs)
                             throws GeomajasException

Get the transformation which converts between two coordinate systems.

Parameters:

sourceCrs - crs used by source data

targetCrs - crs to be used by target

Returns:

transformation matrix

Throws:

GeomajasException - building the transformation is not possible

Since:

1.8.0

transform

com.vividsolutions.jts.geom.Geometry transform(com.vividsolutions.jts.geom.Geometry source,
                                             CrsTransform crsTransform)

Transform a Geometry using the given transformation.

An empty geometry is returned (and a warning logged) if the transformation failed.

Parameters:

source - source geometry

crsTransform - transformation to be applied

Returns:

transformed source, now in target CRS

Since:

1.8.0

transform

com.vividsolutions.jts.geom.Geometry transform(com.vividsolutions.jts.geom.Geometry source,
                                             Crs sourceCrs,
                                             Crs targetCrs)
                                               throws GeomajasException

Transform a Geometry from the source to the target CRS.

An empty geometry is returned (and a warning logged) if the transformation failed.

Parameters:

source - source geometry

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation failed

Since:

1.8.0

transform

com.vividsolutions.jts.geom.Geometry transform(com.vividsolutions.jts.geom.Geometry source,
                                             String sourceCrs,
                                             String targetCrs)
                                               throws GeomajasException

Transform a Geometry from the source to the target CRS.

An empty geometry is returned (and a warning logged) if the transformation failed.

Parameters:

source - source geometry

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation failed

Since:

1.8.0

transform

@Deprecated
com.vividsolutions.jts.geom.Geometry transform(com.vividsolutions.jts.geom.Geometry source,
                                                        CoordinateReferenceSystem sourceCrs,
                                                        CoordinateReferenceSystem targetCrs)
                                               throws GeomajasException

Deprecated. use transform(Geometry, Crs, Crs) instead

Transform a Geometry from the source to the target CRS.

Parameters:

source - source geometry

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation

Since:

1.7.0

transform

com.vividsolutions.jts.geom.Envelope transform(com.vividsolutions.jts.geom.Envelope source,
                                             CrsTransform crsTransform)

Transform a Envelope using the given transformation.

An empty envelope is returned (and a warning logged) if the transformation failed.

Parameters:

source - source envelope

crsTransform - transformation to be applied

Returns:

transformed source, now in target CRS

Since:

1.8.0

transform

com.vividsolutions.jts.geom.Envelope transform(com.vividsolutions.jts.geom.Envelope source,
                                             Crs sourceCrs,
                                             Crs targetCrs)
                                               throws GeomajasException

Transform a Envelope from the source to the target CRS.

An empty envelope is returned (and a warning logged) if the transformation failed.

Parameters:

source - source geometry

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation failed

Since:

1.8.0

transform

com.vividsolutions.jts.geom.Envelope transform(com.vividsolutions.jts.geom.Envelope source,
                                             String sourceCrs,
                                             String targetCrs)
                                               throws GeomajasException

Transform a Envelope from the source to the target CRS.

An empty envelope is returned (and a warning logged) if the transformation failed.

Parameters:

source - source geometry

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation failed

Since:

1.8.0

transform

org.geomajas.geometry.Bbox transform(org.geomajas.geometry.Bbox source,
                                   CrsTransform crsTransform)

Transform a Bbox using the given transformation.

An empty bbox is returned (and a warning logged) if the transformation failed.

Parameters:

source - source bbox

crsTransform - transformation to be applied

Returns:

transformed source, now in target CRS

Since:

1.8.0

transform

org.geomajas.geometry.Bbox transform(org.geomajas.geometry.Bbox source,
                                   Crs sourceCrs,
                                   Crs targetCrs)
                                     throws GeomajasException

Transform a Bbox from the source to the target CRS.

An empty bbox is returned (and a warning logged) if the transformation failed.

Parameters:

source - source bbox

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation

Since:

1.8.0

transform

org.geomajas.geometry.Bbox transform(org.geomajas.geometry.Bbox source,
                                   String sourceCrs,
                                   String targetCrs)
                                     throws GeomajasException

Transform a Bbox from the source to the target CRS.

An empty bbox is returned (and a warning logged) if the transformation failed.

Parameters:

source - source bbox

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation

Since:

1.8.0

transform

com.vividsolutions.jts.geom.Coordinate transform(com.vividsolutions.jts.geom.Coordinate source,
                                               CrsTransform crsTransform)

Transform a Coordinate using the given transformation.

Null is returned (and a warning logged) if the transformation failed.

Parameters:

source - source coordinate

crsTransform - transformation to be applied

Returns:

transformed source, now in target CRS

Since:

1.9.0

transform

com.vividsolutions.jts.geom.Coordinate transform(com.vividsolutions.jts.geom.Coordinate source,
                                               Crs sourceCrs,
                                               Crs targetCrs)
                                                 throws GeomajasException

Transform a Coordinate from the source to the target CRS.

An empty bbox is returned (and a warning logged) if the transformation failed.

Parameters:

source - source bbox

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation

Since:

1.9.0

transform

com.vividsolutions.jts.geom.Coordinate transform(com.vividsolutions.jts.geom.Coordinate source,
                                               String sourceCrs,
                                               String targetCrs)
                                                 throws GeomajasException

Transform a Coordinate from the source to the target CRS.

An empty bbox is returned (and a warning logged) if the transformation failed.

Parameters:

source - source bbox

sourceCrs - source CRS

targetCrs - target CRS

Returns:

transformed source, now in target CRS

Throws:

GeomajasException - building the transformation

Since:

1.8.0

calcDefaultLabelPosition

com.vividsolutions.jts.geom.Coordinate calcDefaultLabelPosition(InternalFeature feature)

Determine a default position for positioning the label for a feature.

Parameters:

feature - feature which needs the label

Returns:

coordinate where the label would make sense.

createCircle

com.vividsolutions.jts.geom.Geometry createCircle(com.vividsolutions.jts.geom.Point center,
                                                double radius,
                                                int nrPoints)

Create a geometry which approximates like a circle.

Parameters:

center - center for the circle

radius - radius for the circle

nrPoints - number of points to calculate for approximating the circle

Returns:

created circle