Package org.opengis.referencing.datum

Interface DatumAuthorityFactory

All Superinterfaces:

AuthorityFactory, Factory

@UML(identifier="CS_CoordinateSystemAuthorityFactory",
     specification=OGC_01009)
public interface DatumAuthorityFactory
extends AuthorityFactory

Creates datum objects 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:

CSAuthorityFactory, CRSAuthorityFactory

Method Summary

Modifier and Type	Method	Description
Datum	createDatum(String code)	Returns an arbitrary datum from a code.
Ellipsoid	createEllipsoid(String code)	Returns an ellipsoid from a code.
EngineeringDatum	createEngineeringDatum(String code)	Returns a engineering datum from a code.
GeodeticDatum	createGeodeticDatum(String code)	Returns a geodetic datum from a code.
ImageDatum	createImageDatum(String code)	Returns a image datum from a code.
ParametricDatum	createParametricDatum(String code)	Returns a parametric datum from a code.
PrimeMeridian	createPrimeMeridian(String code)	Returns a prime meridian from a code.
TemporalDatum	createTemporalDatum(String code)	Returns a temporal datum from a code.
VerticalDatum	createVerticalDatum(String code)	Returns a vertical datum from a code.

Methods inherited from interface AuthorityFactory

createObject, getAuthority, getAuthorityCodes, getDescriptionText

Methods inherited from interface Factory

getVendor

Method Detail

createDatum

Datum createDatum(String code)
           throws NoSuchAuthorityCodeException,
                  FactoryException

Returns an arbitrary datum from a code.

If the datum 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 createGeodeticDatum(code) instead of createDatum(code) if the requested object is known to be a GeodeticDatum instance.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

createGeodeticDatum(String), createVerticalDatum(String), createTemporalDatum(String)

createEngineeringDatum

EngineeringDatum createEngineeringDatum(String code)
                                 throws NoSuchAuthorityCodeException,
                                        FactoryException

Returns a engineering datum from a code.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

CRSAuthorityFactory.createEngineeringCRS(String)

createImageDatum

ImageDatum createImageDatum(String code)
                     throws NoSuchAuthorityCodeException,
                            FactoryException

Returns a image datum from a code.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

CRSAuthorityFactory.createImageCRS(String)

createVerticalDatum

@UML(identifier="createVerticalDatum",
     specification=OGC_01009)
VerticalDatum createVerticalDatum(String code)
                           throws NoSuchAuthorityCodeException,
                                  FactoryException

Returns a vertical datum from a code.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

CRSAuthorityFactory.createVerticalCRS(String)

createTemporalDatum

TemporalDatum createTemporalDatum(String code)
                           throws NoSuchAuthorityCodeException,
                                  FactoryException

Returns a temporal datum from a code.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

CRSAuthorityFactory.createTemporalCRS(String)

createParametricDatum

ParametricDatum createParametricDatum(String code)
                               throws NoSuchAuthorityCodeException,
                                      FactoryException

Returns a parametric datum from a code.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

CRSAuthorityFactory.createParametricCRS(String)

createGeodeticDatum

@UML(identifier="createHorizontalDatum",
     specification=OGC_01009)
GeodeticDatum createGeodeticDatum(String code)
                           throws NoSuchAuthorityCodeException,
                                  FactoryException

Returns a geodetic datum from a code.

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

createEllipsoid(String), createPrimeMeridian(String), CRSAuthorityFactory.createGeographicCRS(String), CRSAuthorityFactory.createProjectedCRS(String)

createEllipsoid

@UML(identifier="createEllipsoid",
     specification=OGC_01009)
Ellipsoid createEllipsoid(String code)
                   throws NoSuchAuthorityCodeException,
                          FactoryException

Returns an ellipsoid from a code.

Parameters:

code - value allocated by authority.

Returns:

the ellipsoid for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

createGeodeticDatum(String)

createPrimeMeridian

@UML(identifier="createPrimeMeridian",
     specification=OGC_01009)
PrimeMeridian createPrimeMeridian(String code)
                           throws NoSuchAuthorityCodeException,
                                  FactoryException

Returns a prime meridian from a code.

Parameters:

code - value allocated by authority.

Returns:

the prime meridian for the given code.

Throws:

NoSuchAuthorityCodeException - if the specified code was not found.

FactoryException - if the object creation failed for some other reason.

See Also:

createGeodeticDatum(String)