AltitudeReferenceSystem Enumeration

2024-05-22

Note

Bing Maps SDK for Android and iOS retirement

Bing Maps SDK for Android and iOS is deprecated and has been retired for all free (Basic) account customers. Enterprise account customers can continue to use Bing Maps SDK for Android and iOS until June 30th, 2028. To avoid service disruptions, all enterprise account customers using Bing Maps SDK for Android and iOS will need to be updated to use Azure Maps Web SDK by June 30th, 2028.

Azure Maps is Microsoft's next-generation maps and geospatial services for developers. Azure Maps has many of the same features as Bing Maps for Enterprise, and more. To get started with Azure Maps, create a free Azure subscription and an Azure Maps account. For more information about azure Maps, see Azure Maps Documentation. For migration guidance, see Bing Maps Migration Overview.

An altitude reference system to indicate what an altitude value is relative to.

Android

enum AltitudeReferenceSystem
{
    UNSPECIFIED,
    TERRAIN,
    ELLIPSOID,
    GEOID,
    SURFACE
}

iOS

typedef NS_ENUM(NSInteger, MSMapAltitudeReferenceSystem)
{
    MSMapAltitudeReferenceSystemUnspecified = 0,
    MSMapAltitudeReferenceSystemTerrain = 1,
    MSMapAltitudeReferenceSystemEllipsoid = 2,
    MSMapAltitudeReferenceSystemGeoid = 3,
    MSMapAltitudeReferenceSystemSurface = 4
}

Values

Unspecified

The altitude value has no meaning.

Terrain

The altitude value is relative to the terrain (not including surface objects like trees and buildings).

Ellipsoid

The altitude value is relative to the WGS84 ellipsoid.

Geoid

The altitude value is relative to sea level.

Surface

The altitude value is relative to the surface (including objects like buildings that are on top of the terrain).

Share via