IGeographicCoordinateSystem2 Interface

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.

Members

	Name	Description
	Abbreviation	The abbreviated name of this spatial reference component.
	Alias	The alias of this spatial reference component.
	AngularConversionFactor	A factor to convert angular units from current GCS to destination GCS.
	Changed	Notify this object that some of its parts have changed (parameter values, z unit, etc.).
	CoordinateUnit	The angular unit of this geographic coordinate system.
	Datum	The horizontal datum of this geographic coordinate system.
	ExtentHint	Calculates a 360 degree longitude range from information in the specified envelope and the domain extent of the GCS.
	FactoryCode	The factory code (WKID) of the spatial reference.
	GetDomain	The XY domain extent.
	GetFalseOriginAndUnits	Get the false origin and units.
	GetGCSParams	Returns the 180 degrees equivalent and horizon delta in proper GCS units.
	GetHorizon	Returns a standard horizon polygon, its envelope and whether it is inclusive or exclusive; the horizon polygon may be 0.
	GetMDomain	The measure domain extent.
	GetMFalseOriginAndUnits	Get the measure false origin and units.
	GetZDomain	The Z domain extent.
	GetZFalseOriginAndUnits	Get the Z false origin and units.
	HasMPrecision	Returns true when m-value precision information has been defined.
	HasXYPrecision	Returns true when (x,y) precision information has been defined.
	HasZPrecision	Returns true when z-value precision information has been defined.
	IsPrecisionEqual	Returns TRUE when the precision information for the two spatial references is the same.
	LeftLongitude	The least (left) longitude bounding a 360 degree range.
	Name	The name of this spatial reference component.
	PrecisionExImpl	An opaque reference to the precision information (including z/m awareness) implementation for this spatial reference.
	PrecisionImpl	An opaque reference to the precision information implementation for this spatial reference.
	PrimeMeridian	The prime meridian of this geographic coordinate system.
	Remarks	The comment string of this spatial reference component.
	RightLongitude	The greatest (right) longitude bounding a 360 degree range.
	SetDomain	The XY domain extent.
	SetFalseOriginAndUnits	Set the false origin and units.
	SetMDomain	The measure domain extent.
	SetMFalseOriginAndUnits	Set the measure false origin and units.
	SetZDomain	The Z domain extent.
	SetZFalseOriginAndUnits	Set the Z false origin and units.
	SpatialReferenceImpl	SpatialReferenceImpl.
	Usage	The usage notes of this geographic coordinate system.
	ZCoordinateUnit	The unit for the Z coordinate.

IGeographicCoordinateSystem2.AngularConversionFactor Property

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

Public Function get_AngularConversionFactor ( _
    ByVal pDstGCS As IGeographicCoordinateSystem2 _
) As Double

public double get_AngularConversionFactor (
    IGeographicCoordinateSystem2 pDstGCS
);

Description

AngularConversionFactorcalculates the value to convert the unit of measure in the current geographic coordinate system to the destination or target geographic coordinate system.

IGeographicCoordinateSystem2.ExtentHint Property

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

Public WriteOnly Property ExtentHint

public void ExtentHint {set;}

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.

IGeographicCoordinateSystem2.GetGCSParams Method

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

Public Sub GetGCSParams ( _
    ByRef p_180 As Double, _
    ByRef pDelta As Double _
)

public void GetGCSParams (
    ref double p_180,
    ref double pDelta
);

Description

GetGCSParamscalculates 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.

IGeographicCoordinateSystem2.GetHorizon Method

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

Public Sub GetHorizon ( _
    ByRef horizonEnvelope As WKSEnvelope _
)

public void GetHorizon (
    ref WKSEnvelope horizonEnvelope
);

Description

GetHorizonreturns an envelope. See also the IProjectedCoordinateSystem2::GetHorizonmethod.

IGeographicCoordinateSystem2.LeftLongitude Property

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

Public Function get_LeftLongitude ( _
    ByVal inDegrees As Boolean _
) As Double

Public Sub set_LeftLongitude ( _
    ByVal inDegrees As Boolean, _
    ByVal LeftLongitude As Double _
)

public double get_LeftLongitude (
    bool inDegrees
);

public void set_LeftLongitude (
    bool inDegrees,
    double LeftLongitude
);

Description

Returns or sets the minimum longitude value for a particular geographic coordinate system.

IGeographicCoordinateSystem2.RightLongitude Property

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

Public Function get_RightLongitude ( _
    ByVal inDegrees As Boolean _
) As Double

Public Sub set_RightLongitude ( _
    ByVal inDegrees As Boolean, _
    ByVal RightLongitude As Double _
)

public double get_RightLongitude (
    bool inDegrees
);

public void set_RightLongitude (
    bool inDegrees,
    double RightLongitude
);

Description

Returns or sets the maximum longitude value for a particular geographic coordinate system.

Inherited Interfaces

Interfaces	Description
IGeographicCoordinateSystem	Provides access to members that control access to all properties of geographic coordinate systems.
ISpatialReference	Provides access to members that control a SpatialReference.
ISpatialReferenceInfo	Provides access to members that control the properties common to all components of a spatial reference system.

Classes that implement IGeographicCoordinateSystem2

Classes	Description
GeographicCoordinateSystem	Creates a geographic coordinate system.