org.opengis.cs
Interface CS_CoordinateSystemAuthorityFactory

All Superinterfaces:
java.rmi.Remote

public interface CS_CoordinateSystemAuthorityFactory
extends java.rmi.Remote

Creates spatial reference objects using codes. The codes are maintained by an external authority. A commonly used authority is EPSG, which is also used in the GeoTIFF standard.

Since:
1.00
Version:
1.01
Author:
Martin Daly

Method Summary
 CS_AngularUnit createAngularUnit(java.lang.String code)
          Returns an AngularUnit object from a code.
 CS_CompoundCoordinateSystem createCompoundCoordinateSystem(java.lang.String code)
          Creates a 3D coordinate system from a code.
 CS_Ellipsoid createEllipsoid(java.lang.String code)
          Returns an Ellipsoid object from a code.
 CS_GeographicCoordinateSystem createGeographicCoordinateSystem(java.lang.String code)
          Returns a GeographicCoordinateSystem object from a code.
 CS_HorizontalCoordinateSystem createHorizontalCoordinateSystem(java.lang.String code)
          Creates a horizontal co-ordinate system from a code.
 CS_HorizontalDatum createHorizontalDatum(java.lang.String code)
          Returns a HorizontalDatum object from a code.
 CS_LinearUnit createLinearUnit(java.lang.String code)
          Returns a LinearUnit object from a code.
 CS_PrimeMeridian createPrimeMeridian(java.lang.String code)
          Returns a PrimeMeridian object from a code.
 CS_ProjectedCoordinateSystem createProjectedCoordinateSystem(java.lang.String code)
          Returns a ProjectedCoordinateSystem object from a code.
 CS_VerticalCoordinateSystem createVerticalCoordinateSystem(java.lang.String code)
          Create a vertical coordinate system from a code.
 CS_VerticalDatum createVerticalDatum(java.lang.String code)
          Creates a vertical datum from a code.
 java.lang.String descriptionText(java.lang.String code)
          Gets a description of the object corresponding to a code.
 java.lang.String geoidFromWKTName(java.lang.String wkt)
          Gets the Geoid code from a WKT name.
 java.lang.String getAuthority()
          Returns the authority name.
 java.lang.String wktGeoidName(java.lang.String geoid)
          Gets the WKT name of a Geoid.
 

Method Detail

getAuthority

public java.lang.String getAuthority()
                              throws java.rmi.RemoteException
Returns the authority name.

Throws:
java.rmi.RemoteException - if a remote method call failed.

createProjectedCoordinateSystem

public CS_ProjectedCoordinateSystem createProjectedCoordinateSystem(java.lang.String code)
                                                             throws java.rmi.RemoteException
Returns a ProjectedCoordinateSystem object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createGeographicCoordinateSystem

public CS_GeographicCoordinateSystem createGeographicCoordinateSystem(java.lang.String code)
                                                               throws java.rmi.RemoteException
Returns a GeographicCoordinateSystem object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createHorizontalDatum

public CS_HorizontalDatum createHorizontalDatum(java.lang.String code)
                                         throws java.rmi.RemoteException
Returns a HorizontalDatum object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createEllipsoid

public CS_Ellipsoid createEllipsoid(java.lang.String code)
                             throws java.rmi.RemoteException
Returns an Ellipsoid object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createPrimeMeridian

public CS_PrimeMeridian createPrimeMeridian(java.lang.String code)
                                     throws java.rmi.RemoteException
Returns a PrimeMeridian object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createLinearUnit

public CS_LinearUnit createLinearUnit(java.lang.String code)
                               throws java.rmi.RemoteException
Returns a LinearUnit object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createAngularUnit

public CS_AngularUnit createAngularUnit(java.lang.String code)
                                 throws java.rmi.RemoteException
Returns an AngularUnit object from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createVerticalDatum

public CS_VerticalDatum createVerticalDatum(java.lang.String code)
                                     throws java.rmi.RemoteException
Creates a vertical datum from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createVerticalCoordinateSystem

public CS_VerticalCoordinateSystem createVerticalCoordinateSystem(java.lang.String code)
                                                           throws java.rmi.RemoteException
Create a vertical coordinate system from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createCompoundCoordinateSystem

public CS_CompoundCoordinateSystem createCompoundCoordinateSystem(java.lang.String code)
                                                           throws java.rmi.RemoteException
Creates a 3D coordinate system from a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

createHorizontalCoordinateSystem

public CS_HorizontalCoordinateSystem createHorizontalCoordinateSystem(java.lang.String code)
                                                               throws java.rmi.RemoteException
Creates a horizontal co-ordinate system from a code. The horizontal coordinate system could be geographic or projected.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

descriptionText

public java.lang.String descriptionText(java.lang.String code)
                                 throws java.rmi.RemoteException
Gets a description of the object corresponding to a code.

Parameters:
code - Value allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.

geoidFromWKTName

public java.lang.String geoidFromWKTName(java.lang.String wkt)
                                  throws java.rmi.RemoteException
Gets the Geoid code from a WKT name. In the OGC definition of WKT horizontal datums, the geoid is referenced by a quoted string, which is used as a key value. This method converts the key value string into a code recognized by this authority.

Parameters:
wkt - Name of geoid defined by OGC (e.g. "European_Datum_1950").
Throws:
java.rmi.RemoteException - if a remote method call failed.

wktGeoidName

public java.lang.String wktGeoidName(java.lang.String geoid)
                              throws java.rmi.RemoteException
Gets the WKT name of a Geoid. In the OGC definition of WKT horizontal datums, the geoid is referenced by a quoted string, which is used as a key value. This method gets the OGC WKT key value from a geoid code.

Parameters:
geoid - Code value for geoid allocated by authority.
Throws:
java.rmi.RemoteException - if a remote method call failed.