Package com.luciad.geodesy

Class CoordinateReferenceProvider

java.lang.Object

com.luciad.geodesy.CoordinateReferenceProvider

public final class CoordinateReferenceProvider
extends Object

Factory to create coordinate references from EPSG and OGC identifiers.

Method Summary

Modifier and Type	Method	Description
static CoordinateReference	create(String identifier)	Creates the coordinate reference from a given EPSG, WKT (version 1) or OGC identifier.

Methods inherited from class java.lang.Object

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

Method Details

create

@NotNull
public static CoordinateReference create(@NotNull
 String identifier)
                                  throws ParseException

Creates the coordinate reference from a given EPSG, WKT (version 1) or OGC identifier.

Supported EPSG codes

A list of supported epsg references can be found here. A list of unsupported epsg references can be found here.

Supported WKT strings

This method supports decoding of WKT version 1 strings.

Within this version of the standard, the following types of references are supported:

• Geographic (aka geodetic) references: WKT strings that start with "GEOGCS"
• Geocentric references: WKT strings that start with "GEOCCS"
• Projected (aka grid) references: WKT strings that start with "PROJCS" or "FITTED_CS"
• Topocentric references: WKT strings that start with ENGCRS and have a topocentric deriving conversion method with authority EPSG:9837.

References with a vertical datum (strings that start with "COMPD_CS") are not supported.

Example usage

Creation of the WGS-84 coordinate reference system with an EPSG identifier.

String identifier = "EPSG:4326";
CoordinateReference crs = CoordinateReferenceProvider.create(identifier);

Creation of the WGS-84 coordinate reference system with a WKT identifier.

String identifier = "GEOGCS[\"WGS 84\",DATUM[\"World Geodetic System 1984\",SPHEROID[\"WGS 84\",6378137.0,298.257223563],TOWGS84[0.0,0.0,0.0]],PRIMEM[\"Greenwich\",0.0],UNIT[\"degree\",0.017453292519943295],AXIS[\"Geodetic latitude\",NORTH],AXIS[\"Geodetic longitude\",EAST],AUTHORITY[\"EPSG\",4326]]";
CoordinateReference crs = CoordinateReferenceProvider.create(identifier);

Creation of the Web Mercator coordinate reference system with an OGC identifier.

String identifier = "urn:ogc:def:crs:EPSG::3857";
CoordinateReference crs = CoordinateReferenceProvider.create(identifier);

Parameters:

identifier - an EPSG, WKT (version 1) or OGC identifier, for example "EPSG:3857" or "urn:ogc:def:crs:EPSG::3857".

Returns:

the coordinate reference.

Throws:

ParseException - when the coordinate reference is not supported or cannot be parsed.