org.geotools.cs
Class GeographicCoordinateSystem

java.lang.Object
  org.geotools.cs.Info
      org.geotools.cs.CoordinateSystem
          org.geotools.cs.HorizontalCoordinateSystem
              org.geotools.cs.GeographicCoordinateSystem

All Implemented Interfaces:

org.opengis.referencing.crs.CoordinateReferenceSystem, Dimensioned, org.opengis.referencing.IdentifiedObject, org.opengis.referencing.ReferenceSystem, java.io.Serializable

Deprecated. Replaced by DefaultGeographicCRS.

public class GeographicCoordinateSystem

extends HorizontalCoordinateSystem

A coordinate system based on latitude and longitude. Some geographic coordinate systems are latitude/longiude, and some are longitude/latitude. You can find out which this is by examining the axes. You should also check the angular units, since not all geographic coordinate systems use degrees.

Version:

$Id: GeographicCoordinateSystem.java 17672 2006-01-19 00:25:55Z desruisseaux $

Author:

OpenGIS (www.opengis.org), Martin Desruisseaux

See Also:

CS_GeographicCoordinateSystem, Serialized Form

Field Summary

static GeographicCoordinateSystem

WGS84 Deprecated. A geographic coordinate system using WGS84 datum.

Fields inherited from interface org.opengis.referencing.ReferenceSystem

SCOPE_KEY, VALID_AREA_KEY

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

GeographicCoordinateSystem(java.lang.CharSequence name, HorizontalDatum datum)
Deprecated. Creates a geographic coordinate system.

GeographicCoordinateSystem(java.lang.CharSequence name, Unit unit, HorizontalDatum datum, PrimeMeridian meridian, AxisInfo axis0, AxisInfo axis1)
Deprecated. Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

Method Summary

boolean	equals(Info object, boolean compareNames) Deprecated. Compare this coordinate system with the specified object for equality.
Envelope	getDefaultEnvelope() Deprecated. Gets default envelope of coordinate system.
PrimeMeridian	getPrimeMeridian() Deprecated. Replaced by DefaultGeodeticDatum.getPrimeMeridian().
Unit	getUnits(int dimension) Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().
java.util.Set	getWGS84ConversionInfos() Deprecated. Gets details on conversions to WGS84.
int	hashCode() Deprecated. Returns a hash value for this coordinate system.

Methods inherited from class org.geotools.cs.HorizontalCoordinateSystem

getAxis, getDimension, getHorizontalDatum

Methods inherited from class org.geotools.cs.CoordinateSystem

fromGeoAPI, getCoordinateSystem, getDatum, getScope, getValidArea

Methods inherited from class org.geotools.cs.Info

ensureNonNull, equals, getAbbreviation, getAlias, getAlias, getAuthority, getAuthorityCode, getIdentifiers, getName, getRemarks, toString, toWKT

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Field Detail

WGS84

public static final GeographicCoordinateSystem WGS84

Deprecated.

A geographic coordinate system using WGS84 datum. This coordinate system uses longitude/latitude ordinates with longitude values increasing north and latitude values increasing east. Angular units are degrees and prime meridian is Greenwich.

Constructor Detail

GeographicCoordinateSystem

public GeographicCoordinateSystem(java.lang.CharSequence name,
                                  HorizontalDatum datum)

Deprecated.

Creates a geographic coordinate system. This coordinate system will use longitude/latitude ordinates with longitude values increasing east and latitude values increasing north. Angular units are degrees and prime meridian is Greenwich.

Parameters:

name - Name to give new object.

datum - Horizontal datum for created coordinate system.

GeographicCoordinateSystem

public GeographicCoordinateSystem(java.lang.CharSequence name,
                                  Unit unit,
                                  HorizontalDatum datum,
                                  PrimeMeridian meridian,
                                  AxisInfo axis0,
                                  AxisInfo axis1)

Deprecated.

Creates a geographic coordinate system, which could be latitude/longiude or longitude/latitude.

Parameters:

name - Name to give new object.

unit - Angular units for created coordinate system.

datum - Horizontal datum for created coordinate system.

meridian - Prime Meridian for created coordinate system.

axis0 - Details of 0th ordinates.

axis1 - Details of 1st ordinates.

See Also:

CS_CoordinateSystemFactory.createGeographicCoordinateSystem(java.lang.String, org.opengis.cs.CS_AngularUnit, org.opengis.cs.CS_HorizontalDatum, org.opengis.cs.CS_PrimeMeridian, org.opengis.cs.CS_AxisInfo, org.opengis.cs.CS_AxisInfo)

Method Detail

getUnits

public Unit getUnits(int dimension)

Deprecated. Replaced by DefaultCoordinateSystemAxis.getUnit().

Gets units for dimension within coordinate system. This angular unit is the same for all axes.

Specified by:

getUnits in class CoordinateSystem

Parameters:

dimension - Zero based index of axis.

See Also:

CS_CoordinateSystem.getUnits(int)

getPrimeMeridian

public PrimeMeridian getPrimeMeridian()

Deprecated. Replaced by DefaultGeodeticDatum.getPrimeMeridian().

Returns the prime meridian.

See Also:

CS_GeographicCoordinateSystem.getPrimeMeridian()

getDefaultEnvelope

public Envelope getDefaultEnvelope()

Deprecated.

Gets default envelope of coordinate system.

Overrides:

getDefaultEnvelope in class CoordinateSystem

See Also:

CS_CoordinateSystem.getDefaultEnvelope()

getWGS84ConversionInfos

public java.util.Set getWGS84ConversionInfos()

Deprecated.

Gets details on conversions to WGS84. Some geographic coordinate systems provide several transformations into WGS84, which are designed to provide good accuracy in different areas of interest. The first conversion should provide acceptable accuracy over the largest possible area of interest.

Returns:

A set of conversions info to WGS84. The default implementation returns an empty set.

See Also:

CS_GeographicCoordinateSystem.getNumConversionToWGS84(), CS_GeographicCoordinateSystem.getWGS84ConversionInfo(int)

equals

public boolean equals(Info object,
                      boolean compareNames)

Deprecated.

Compare this coordinate system with the specified object for equality.

Overrides:

equals in class HorizontalCoordinateSystem

Parameters:

object - The object to compare to this.

compareNames - true to comparare the name, alias, authority code, etc. as well, or false to compare only properties relevant to transformations.

Returns:

true if both objects are equal.

hashCode

public int hashCode()

Deprecated.

Returns a hash value for this coordinate system. Name, alias, authority code and the like are not taken in account. In other words, two coordinate systems will return the same hash value if they are equal in the sense of equals(Info, false).

Overrides:

hashCode in class HorizontalCoordinateSystem

Returns:

The hash code value. This value doesn't need to be the same in past or future versions of this class.