GeoAPI 1.0
Build 2004-05-18

org.opengis.referencing.crs
Interface CRSAuthorityFactory

All Superinterfaces:
AuthorityFactory

public interface CRSAuthorityFactory
extends AuthorityFactory

Creates coordinate reference 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, which is also used in the GeoTIFF standard.

Version:
Implementation specification 1.0
Author:
OpenGIS® consortium
See Also:
CSAuthorityFactory, DatumAuthorityFactory
UML identifier (abstract type): CS_CoordinateSystemAuthorityFactory  in 1.0 specification

Method Summary
 CompoundCRS createCompoundCRS(String code)
          Creates a 3D coordinate reference system from a code.
 CoordinateReferenceSystem createCoordinateReferenceSystem(String code)
          Returns an arbitrary coordinate reference system from a code.
 DerivedCRS createDerivedCRS(String code)
          Creates a derived coordinate reference system from a code.
 EngineeringCRS createEngineeringCRS(String code)
          Create a engineering coordinate reference system from a code.
 GeocentricCRS createGeocentricCRS(String code)
          Returns a geocentric coordinate reference system from a code.
 GeographicCRS createGeographicCRS(String code)
          Returns a geographic coordinate reference system from a code.
 ImageCRS createImageCRS(String code)
          Create a image coordinate reference system from a code.
 ProjectedCRS createProjectedCRS(String code)
          Returns a projected coordinate reference system from a code.
 TemporalCRS createTemporalCRS(String code)
          Create a temporal coordinate reference system from a code.
 VerticalCRS createVerticalCRS(String code)
          Create a vertical coordinate reference system from a code.
 
Methods inherited from interface AuthorityFactory
createObject, getAuthority, getAuthorityCodes, getDescriptionText, getFactory
 

Method Detail

createCoordinateReferenceSystem

CoordinateReferenceSystem createCoordinateReferenceSystem(String code)
                                                          throws FactoryException
Returns an arbitrary coordinate reference system from a code. If the coordinate reference system type is know at compile time, it is recommended to invoke the most precise method instead of this one (for example  createGeographicCRS(code)  instead of  createCoordinateReferenceSystem(code)  if the caller know he is asking for a geographic coordinate reference system).

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.
See Also:
createGeographicCRS(java.lang.String), createProjectedCRS(java.lang.String), createVerticalCRS(java.lang.String), createTemporalCRS(java.lang.String), createCompoundCRS(java.lang.String)

createCompoundCRS

CompoundCRS createCompoundCRS(String code)
                              throws FactoryException
Creates a 3D coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.
UML identifier (operation): createCompoundCoordinateSystem  in 1.0 specification

createDerivedCRS

DerivedCRS createDerivedCRS(String code)
                            throws FactoryException
Creates a derived coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.

createEngineeringCRS

EngineeringCRS createEngineeringCRS(String code)
                                    throws FactoryException
Create a engineering coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.

createGeographicCRS

GeographicCRS createGeographicCRS(String code)
                                  throws FactoryException
Returns a geographic coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.
See Also:
DatumAuthorityFactory.createGeodeticDatum(java.lang.String)
UML identifier (operation): createGeographicCoordinateSystem  in 1.0 specification

createGeocentricCRS

GeocentricCRS createGeocentricCRS(String code)
                                  throws FactoryException
Returns a geocentric coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
FactoryException - if the object creation failed.
See Also:
DatumAuthorityFactory.createGeodeticDatum(java.lang.String)
UML identifier (operation): createGeocentricCoordinateSystem  in 1.0 specification

createImageCRS

ImageCRS createImageCRS(String code)
                        throws FactoryException
Create a image coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.

createProjectedCRS

ProjectedCRS createProjectedCRS(String code)
                                throws FactoryException
Returns a projected coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.
See Also:
DatumAuthorityFactory.createGeodeticDatum(java.lang.String)
UML identifier (operation): createProjectedCoordinateSystem  in 1.0 specification

createTemporalCRS

TemporalCRS createTemporalCRS(String code)
                              throws FactoryException
Create a temporal coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.
See Also:
DatumAuthorityFactory.createTemporalDatum(java.lang.String)

createVerticalCRS

VerticalCRS createVerticalCRS(String code)
                              throws FactoryException
Create a vertical coordinate reference system from a code.

Parameters:
code - Value allocated by authority.
Throws:
NoSuchAuthorityCodeException - if the specified code was not found.
FactoryException - if the object creation failed for some other reason.
See Also:
DatumAuthorityFactory.createVerticalDatum(java.lang.String)
UML identifier (operation): createVerticalCoordinateSystem  in 1.0 specification

GeoAPI 1.0
Build 2004-05-18

Symbols, terms and definitions
Copyright OpenGIS® Consortium