com.esri.arcgis.geometry
Interface IGeographicCoordinateSystem2

All Superinterfaces:

IGeographicCoordinateSystem, ISpatialReference, ISpatialReferenceInfo, Serializable

All Known Implementing Classes:

GeographicCoordinateSystem

public interface IGeographicCoordinateSystem2
extends IGeographicCoordinateSystem, Serializable

Provides access to members that control additional properties and methods for all geographic coordinate systems.

When To Use

Use IGeographicCoordinateSystem2 when you need to work with map projection horizons or transform between two geographic coordinate systems.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

double	getAngularConversionFactor(IGeographicCoordinateSystem2 pDstGCS) A factor to convert angular units from current GCS to destination GCS.
void	getGCSParams(double[] p_180, double[] pDelta) Returns the 180 degrees equivalent and horizon delta in proper GCS units.
void	getHorizon(_WKSEnvelope[] horizonEnvelope) Returns a standard horizon polygon, its envelope and whether it is inclusive or exclusive; the horizon polygon may be 0.
double	getLeftLongitude(boolean inDegrees) The least (left) longitude bounding a 360 degree range.
double	getRightLongitude(boolean inDegrees) The greatest (right) longitude bounding a 360 degree range.
void	setExtentHint(_WKSEnvelope rhs1) Calculates a 360 degree longitude range from information in the specified envelope and the domain extent of the GCS.
void	setLeftLongitude(boolean inDegrees, double leftLongitude) The least (left) longitude bounding a 360 degree range.
void	setRightLongitude(boolean inDegrees, double rightLongitude) The greatest (right) longitude bounding a 360 degree range.

Methods inherited from interface com.esri.arcgis.geometry.IGeographicCoordinateSystem

getCoordinateUnit, getDatum, getPrimeMeridian, getUsage

Methods inherited from interface com.esri.arcgis.geometry.ISpatialReference

changed, getDomain, getFalseOriginAndUnits, getMDomain, getMFalseOriginAndUnits, getZCoordinateUnit, getZDomain, getZFalseOriginAndUnits, hasMPrecision, hasXYPrecision, hasZPrecision, isPrecisionEqual, setDomain, setFalseOriginAndUnits, setMDomain, setMFalseOriginAndUnits, setZCoordinateUnit, setZDomain, setZFalseOriginAndUnits

Methods inherited from interface com.esri.arcgis.geometry.ISpatialReferenceInfo

getAbbreviation, getAlias, getFactoryCode, getName, getRemarks

Method Detail

getGCSParams

void getGCSParams(double[] p_180,
                  double[] pDelta)
                  throws IOException,
                         AutomationException

Returns the 180 degrees equivalent and horizon delta in proper GCS units.

Description

GetGCSParams calculates the edge of the horizon for a geographic coordinate system. For example, if your coordinate system is in decimal degrees, 180 is returned. If the units are in grads, 200 is returned. It also returns a delta, a small offset value, in the correct unit of measure.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

p_180 - The p_180 (out: use single element array)

pDelta - The pDelta (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getHorizon

void getHorizon(_WKSEnvelope[] horizonEnvelope)
                throws IOException,
                       AutomationException

Returns a standard horizon polygon, its envelope and whether it is inclusive or exclusive; the horizon polygon may be 0.

Description

GetHorizon returns an envelope. See also the IProjectedCoordinateSystem2::GetHorizon method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

horizonEnvelope - A Structure: com.esri.arcgis.system._WKSEnvelope (A com.esri.arcgis.system._WKSEnvelope COM typedef) (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAngularConversionFactor

double getAngularConversionFactor(IGeographicCoordinateSystem2 pDstGCS)
                                  throws IOException,
                                         AutomationException

A factor to convert angular units from current GCS to destination GCS.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

pDstGCS - A reference to a com.esri.arcgis.geometry.IGeographicCoordinateSystem2 (in)

Returns:

The pFactor

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLeftLongitude

double getLeftLongitude(boolean inDegrees)
                        throws IOException,
                               AutomationException

The least (left) longitude bounding a 360 degree range.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

inDegrees - The inDegrees (in)

Returns:

The leftLongitude

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLeftLongitude

void setLeftLongitude(boolean inDegrees,
                      double leftLongitude)
                      throws IOException,
                             AutomationException

The least (left) longitude bounding a 360 degree range.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

inDegrees - The inDegrees (in)

leftLongitude - The leftLongitude (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRightLongitude

double getRightLongitude(boolean inDegrees)
                         throws IOException,
                                AutomationException

The greatest (right) longitude bounding a 360 degree range.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

inDegrees - The inDegrees (in)

Returns:

The rightLongitude

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setRightLongitude

void setRightLongitude(boolean inDegrees,
                       double rightLongitude)
                       throws IOException,
                              AutomationException

The greatest (right) longitude bounding a 360 degree range.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

inDegrees - The inDegrees (in)

rightLongitude - The rightLongitude (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setExtentHint

void setExtentHint(_WKSEnvelope rhs1)
                   throws IOException,
                          AutomationException

Calculates a 360 degree longitude range from information in the specified envelope and the domain extent of the GCS.

Description

The ExtentHint, LeftLongitude, and RightLongitude properties are interrelated. Usually, data in a geographic coordinate system has longitude values between -180 and 180 if the unit of measure is degrees. Some datasets are designed to use a minimum longitude value of 0 or -360. The LeftLongitude property controls whether the data is considered as -360 to 0, -180 to 180, or 0 to 360. If two datasets have spatial references with different LeftLongitude values, one needs to be converted to match the other one. You can do this with the GeoNormalize method on IGeometry. ExtentHint is calculated internally by looking at the extent of the data. If the results used to set the LeftLongitude property are incorrect, you can use an envelope to set ExtentHint.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

rhs1 - A Structure: com.esri.arcgis.system._WKSEnvelope (A com.esri.arcgis.system._WKSEnvelope COM typedef) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.