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

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

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.

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.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.