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.

Supported Platforms

Windows, Solaris, Linux


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.