Terrain and Ellipsoid Height Services

Heights

The terrain and ellipsoid height service returns terrain and ellipsoid heights at a specific location, measured in meters. The heights are referenced to either WGS84 or mean sea level (MSL), specified in the output.

API Path
/terrain/heights?u=APIKEY&latitude=xx.xx&longitude=xx.xx
HTTP Method
GET
Input Format
latitude
The latitude of the location for which the heights are desired. Degrees, -90 to 90 inclusive.
longitude
The longitude of the location for which the heights are desired. Degrees, -360 to 360 inclusive.
Input Sample
    /terrain/heights?u=APIKEY&latitude=38.840318&longitude=-105.043498
Output Sample
{
    "TerrainHeightFromWgs84": 4283.1394147693254,
    "MeanSeaLevelHeightFromWgs84": -16.108077610647548,
    "TerrainHeightFromMeanSeaLevel": 4299.2474923799728
}

Heights along routes

These services return terrain and ellipsoid heights at each propagated route point, measured in meters. These services use the exact same input data as the routing services by the same name. You specify the output frequency by setting the OutputSettings Step property. Be sure to read the descriptions of these routes to understand their behavior.

API Paths
/terrain/pointToPoint
/terrain/greatArc
HTTP Method
POST
Input Format

The service /terrain/pointToPoint uses the same input format as the point to point route.

The service /terrain/greatArc uses the same input format as the great arc route.

Input Sample

In this example, a great arc route definition is passed to the /terrain/greatArc service, specifying outputs route points and terrain every hour.

{
    "Waypoints": [
        {
            "Position": {
                "Latitude": 39.07096,
                "Longitude": -104.78509,
                "Altitude": 20000.0
            },
            "Time": "2014-02-10T10:30:00"
        },
        {
            "Position": {
                "Latitude": 42.64541,
                "Longitude": -61.11172,
                "Altitude": 100.0
            },
            "Time": "2014-02-10T18:30:20"
        }
    ],
    "OutputSettings": {
        "Step": 3600,
        "TimeFormat": "UTC"
        }
    }
}
Output Sample
[
    {
        "Location": {
            "Position": {
                "Latitude": 39.070959999999992,
                "Longitude": -104.78509,
                "Altitude": 19999.99999999674
            },
            "SensorStates": [],
            "Time": "2014-02-10T10:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 2269.8768211820689,
        "MeanSeaLevelHeightFromWgs84": -16.97488638259188,
        "TerrainHeightFromMeanSeaLevel": 2286.851707564661
    },
    {
        "Location": {
            "Position": {
                "Latitude": 40.409135934247665,
                "Longitude": -99.735909778094481,
                "Altitude": 19689.493908200337
            },
            "SensorStates": [],
            "Time": "2014-02-10T11:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 695.53484603515892,
        "MeanSeaLevelHeightFromWgs84": -25.014392420853689,
        "TerrainHeightFromMeanSeaLevel": 720.54923845601263
    },
    {
        "Location": {
            "Position": {
                "Latitude": 41.518206830625132,
                "Longitude": -94.50069797114557,
                "Altitude": 18757.975632811649
            },
            "SensorStates": [],
            "Time": "2014-02-10T12:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 346.92964604925618,
        "MeanSeaLevelHeightFromWgs84": -29.100362139165181,
        "TerrainHeightFromMeanSeaLevel": 376.03000818842133
    },
    {
        "Location": {
            "Position": {
                "Latitude": 42.381174600153429,
                "Longitude": -89.104340828032818,
                "Altitude": 17205.4451738269
            },
            "SensorStates": [],
            "Time": "2014-02-10T13:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 198.58821637743014,
        "MeanSeaLevelHeightFromWgs84": -33.889143581452444,
        "TerrainHeightFromMeanSeaLevel": 232.47735995888257
    },
    {
        "Location": {
            "Position": {
                "Latitude": 42.983743771912771,
                "Longitude": -83.581203500872689,
                "Altitude": 15031.902531251159
            },
            "SensorStates": [],
            "Time": "2014-02-10T14:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 209.88330134918229,
        "MeanSeaLevelHeightFromWgs84": -34.581382199163357,
        "TerrainHeightFromMeanSeaLevel": 244.46468354834565
    },
    {
        "Location": {
            "Position": {
                "Latitude": 43.315326594380956,
                "Longitude": -77.973939082536958,
                "Altitude": 12237.347705084667
            },
            "SensorStates": [],
            "Time": "2014-02-10T15:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 62.3936654074555,
        "MeanSeaLevelHeightFromWgs84": -36.427065755801905,
        "TerrainHeightFromMeanSeaLevel": 98.8207311632574
    },
    {
        "Location": {
            "Position": {
                "Latitude": 43.36987065567763,
                "Longitude": -72.331117716361447,
                "Altitude": 8821.7806953192539
            },
            "SensorStates": [],
            "Time": "2014-02-10T16:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": 132.685121525746,
        "MeanSeaLevelHeightFromWgs84": -27.887720042336277,
        "TerrainHeightFromMeanSeaLevel": 160.57284156808228
    },
    {
        "Location": {
            "Position": {
                "Latitude": 43.146364440527961,
                "Longitude": -66.7039127226227,
                "Altitude": 4785.20150196308
            },
            "SensorStates": [],
            "Time": "2014-02-10T17:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": -24.227989007422309,
        "MeanSeaLevelHeightFromWgs84": -24.228003657844184,
        "TerrainHeightFromMeanSeaLevel": 0.000014650421874762287
    },
    {
        "Location": {
            "Position": {
                "Latitude": 42.648924149520994,
                "Longitude": -61.142346572194612,
                "Altitude": 127.61012501253818
            },
            "SensorStates": [],
            "Time": "2014-02-10T18:30:00.0000000Z"
        },
        "TerrainHeightFromWgs84": -23.668606070877871,
        "MeanSeaLevelHeightFromWgs84": -23.668185383421022,
        "TerrainHeightFromMeanSeaLevel": -0.00042068745684886721
    },
    {
        "Location": {
            "Position": {
                "Latitude": 42.64541,
                "Longitude": -61.11172,
                "Altitude": 100.0000000005448
            },
            "SensorStates": [],
            "Time": "2014-02-10T18:30:20.0000000Z"
        },
        "TerrainHeightFromWgs84": -23.694280635974625,
        "MeanSeaLevelHeightFromWgs84": -23.694065803008026,
        "TerrainHeightFromMeanSeaLevel": -0.00021483296659852158
    }
]