Module org.opengis.geoapi

Package org.opengis.referencing.crs

Interface ProjectedCRS

All Superinterfaces:

CoordinateReferenceSystem, DerivedCRS, GeneralDerivedCRS, IdentifiedObject, ReferenceSystem, SingleCRS

@UML(identifier="ProjectedCRS",
     specification=ISO_19111)
public interface ProjectedCRS
extends DerivedCRS

A 2- or 3-dimensional CRS based on an approximation of the shape of the planet's surface by a plane. It is done in such a way that the distortion that is inherent to the approximation is carefully controlled and known. Distortion correction is commonly applied to calculated bearings and distances to produce values that are a close match to actual field values.

Permitted coordinate systems

This type of CRS can be used with coordinate systems of type CartesianCS only.

Since:

1.0

See Also:

• CRSAuthorityFactory.createProjectedCRS(String)
• CRSFactory.createProjectedCRS(Map, GeographicCRS, Conversion, CartesianCS)

Field Summary

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, DOMAINS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Fields inherited from interface org.opengis.referencing.ReferenceSystem

DOMAIN_OF_VALIDITY_KEY, SCOPE_KEY

Method Summary

Modifier and Type	Method	Description
GeographicCRS	getBaseCRS()	Returns the CRS that is the base for this projected CRS.
Projection	getConversionFromBase()	Returns the map projection from the base CRS to this projected CRS.
CartesianCS	getCoordinateSystem()	Returns the coordinate system, which shall be Cartesian.
default GeodeticDatum	getDatum()	Returns the same datum as the base geodetic CRS.
default DatumEnsemble<GeodeticDatum>	getDatumEnsemble()	Returns the same datum ensemble as the base geodetic CRS.

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getDomains, getIdentifiers, getName, getRemarks, toWKT

Methods inherited from interface org.opengis.referencing.ReferenceSystem

getDomainOfValidity, getScope

Method Details

getBaseCRS

GeographicCRS getBaseCRS()

Returns the CRS that is the base for this projected CRS. This is the source CRS of the deriving conversion.

Upcoming API change — conformance
The CRS type should be GeodeticCRS according ISO 19111:2019. This change may be applied in GeoAPI 4.0. In preparation for this possible change, users should assign the returned value to GeodeticCRS only.

Specified by:

getBaseCRS in interface DerivedCRS

Specified by:

getBaseCRS in interface GeneralDerivedCRS

Returns:

the CRS that is the base for this projected CRS.

getConversionFromBase

Projection getConversionFromBase()

Returns the map projection from the base CRS to this projected CRS. The source CRS of the conversion, if non null, shall be the base CRS. The target CRS of the conversion, if non-null, shall be this CRS.

Upcoming API change — conformance
The Projection type is not part of OGC/ISO abstract specification. This change may be applied in GeoAPI 4.0. In preparation for this possible change, users should assign the returned value to Conversion only.

Specified by:

getConversionFromBase in interface DerivedCRS

Specified by:

getConversionFromBase in interface GeneralDerivedCRS

Returns:

the map projection from the base CRS to this projected CRS.

getCoordinateSystem

@UML(identifier="coordinateSystem",
     obligation=MANDATORY,
     specification=ISO_19111)
CartesianCS getCoordinateSystem()

Returns the coordinate system, which shall be Cartesian. In the 3D case the ellipsoidal height from the base CRS is retained to form a three-dimensional Cartesian coordinate system.

Specified by:

getCoordinateSystem in interface CoordinateReferenceSystem

Specified by:

getCoordinateSystem in interface SingleCRS

Returns:

the Cartesian coordinate system associated to this projected CRS.

getDatum

@UML(identifier="datum",
     obligation=MANDATORY,
     specification=ISO_19111)
default GeodeticDatum getDatum()

Returns the same datum as the base geodetic CRS. This property may be null if the base CRS is related to an object identified only by a datum ensemble.

Specified by:

getDatum in interface DerivedCRS

Specified by:

getDatum in interface SingleCRS

Returns:

the datum of the base geodetic CRS, or null if the base is related to an object identified only by a datum ensemble.

getDatumEnsemble

default DatumEnsemble<GeodeticDatum> getDatumEnsemble()

Returns the same datum ensemble as the base geodetic CRS. This property may be null if the base CRS is related to an object identified only by a single datum.

Specified by:

getDatumEnsemble in interface DerivedCRS

Specified by:

getDatumEnsemble in interface SingleCRS

Returns:

the datum ensemble of the base geodetic CRS, or null if the base is related to an object identified only by a single datum.

Since:

3.1