SDSP SERVICES
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 ellipsoid or mean sea level (MSL) geoid, specified in the output.
/terrain/heights?u=APIKEY&latitude=38.840318&longitude=-105.043498
{
"TerrainHeightFromWgs84": 4283.1394147693254,
"MeanSeaLevelHeightFromWgs84": -16.108077610647548,
"TerrainHeightFromMeanSeaLevel": 4299.2474923799728
}
There is a good overview of the different height systems at the ESRI website here.
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.
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.
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"
}
}
}
[
{
"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
}
]
There is a good overview of the different height systems at the ESRI website here.