- All Superinterfaces:
AuthorityFactory
,Factory
- All Known Implementing Classes:
PseudoEpsgFactory
Creates coordinate systems using authority codes.
External authorities are used to manage definitions of objects used in this interface.
The definitions of these objects are referenced using code strings.
A commonly used authority is EPSG.
- Since:
- 1.0
- See Also:
- Departure from OGC/ISO abstract specification:
Departure for historical reason
Added for consistency with CRS and datum factories. This CS factory was not defined in the OGC specification because OGC 01-009 was created before ISO 19111 and had no equivalent of the ISO Coordinate System types.
-
Method Summary
Modifier and TypeMethodDescriptioncreateCartesianCS
(String code) Returns a Cartesian coordinate system from a code.createCoordinateSystem
(String code) Returns an arbitrary coordinate system from a code.Returns a coordinate system axis from a code.createCylindricalCS
(String code) Returns a cylindrical coordinate system from a code.createEllipsoidalCS
(String code) Returns an ellipsoidal coordinate system from a code.createParametricCS
(String code) Returns a parametric coordinate system from a code.createPolarCS
(String code) Returns a polar coordinate system from a code.createSphericalCS
(String code) Returns a spherical coordinate system from a code.createTimeCS
(String code) Returns a temporal coordinate system from a code.Unit<?>
createUnit
(String code) Returns an unit of measurement from a code.createVerticalCS
(String code) Returns a vertical coordinate system from a code.Methods inherited from interface AuthorityFactory
createObject, getAuthority, getAuthorityCodes, getDescriptionText
-
Method Details
-
createCoordinateSystem
CoordinateSystem createCoordinateSystem(String code) throws NoSuchAuthorityCodeException, FactoryException Returns an arbitrary coordinate system from a code.If the coordinate system type is known at compile time, then it is recommended to invoke the most precise method instead of this one. For example, it is usually better to invoke
createCartesianCS(code)
instead ofcreateCoordinateSystem(code)
if the requested object is known to be aCartesianCS
instance.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createCartesianCS
Returns a Cartesian coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createPolarCS
Returns a polar coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createCylindricalCS
CylindricalCS createCylindricalCS(String code) throws NoSuchAuthorityCodeException, FactoryException Returns a cylindrical coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createSphericalCS
Returns a spherical coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createEllipsoidalCS
EllipsoidalCS createEllipsoidalCS(String code) throws NoSuchAuthorityCodeException, FactoryException Returns an ellipsoidal coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createVerticalCS
Returns a vertical coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createTimeCS
Returns a temporal coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createParametricCS
Returns a parametric coordinate system from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the coordinate system for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createCoordinateSystemAxis
CoordinateSystemAxis createCoordinateSystemAxis(String code) throws NoSuchAuthorityCodeException, FactoryException Returns a coordinate system axis from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the axis for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-
createUnit
@UML(identifier="CS_CoordinateSystemAuthorityFactory.createLinearUnit, createAngularUnit", specification=OGC_01009) Unit<?> createUnit(String code) throws NoSuchAuthorityCodeException, FactoryException Returns an unit of measurement from a code.- Parameters:
code
- value allocated by authority.- Returns:
- the unit for the given code.
- Throws:
NoSuchAuthorityCodeException
- if the specifiedcode
was not found.FactoryException
- if the object creation failed for some other reason.
-