GeoElevationData

GeoElevationData[]

gives the elevation above sea level at $GeoLocation.

GeoElevationData[loc]

gives the elevation at the geographic location loc.

GeoElevationData[{loc1,loc2}]

gives an array of elevation values within the bounding box given by {loc1,loc2}.

GeoElevationData[GeoPosition[{{lat1,lon1},{lat2,lon2},…}]]

gives the list of elevations at the positions {lati,loni}.

GeoElevationData[loc,etype]

gives the elevation of type etype for the location loc.

GeoElevationData[loc,etype,format]

gives the elevation in the specified format.

Details and Options

  • The location loc can be specified as latitude and longitude coordinates {lat,lon}, GeoPosition[…], or as a named entity Entity[…].
  • GeoElevationData returns by default orthometric height, namely the elevation with respect to the geoid (mean sea level).
  • In GeoElevationData[loc,etype] possible types etype of elevation include:
  • Automaticequivalent to "Orthometric"
    "Center"elevation of the topography with respect the Earth's center
    "Geodetic"elevation of the topography with respect to the ellipsoid
    "Orthometric"elevation of the topography with respect to the geoid
    "Undulation"elevation of the geoid with respect to the ellipsoid
  • For a specific location, GeoElevationData returns by default a Quantity corresponding to the closest point in the underlying elevation dataset.
  • For a region, GeoElevationData returns by default a QuantityArray of elevation values. Successive rows of the array correspond to decreasing latitude, and successive columns correspond to increasing longitude. The QuantityArray has a unit that may be specified using UnitSystem.
  • GeoElevationData[Entity[…]] returns an array of values irrespective of whether the entity is "extended" or not.
  • The spatial resolution of an elevation array is dependent on available data.
  • In GeoElevationData[loc,etype,format] possible output formats include:
  • Automaticequivalent to "QuantityArray"
    "QuantityArray"Quantity or QuantityArray object
    "Quantity"Quantity object, possibly with ThreadDepth option
    "GeoPosition"GeoPosition with points {lat,lon,height}
    "GeoPositionXYZ"GeoPositionXYZ with Earth-centered points {x,y,z}
    "Region"geometric region with elevation of the area
  • The following options can be given to GeoElevationData:
  • GeoModelAutomaticgeo model of locations
    GeoZoomLevelAutomaticlevel of resolution of the elevation array
    UnitSystem$UnitSystemunit system in which to return elevations
  • GeoElevationData[…, GeoModel"Moon"] gives elevation for a location or region on the Moon.
  • The following settings for UnitSystem can be used:
  • "Imperial"return results in imperial units
    "Metric"return results in metric units
  • The spatial resolution of the requested elevation data can be selected subject to availability with GeoZoomLevel, where GeoZoomLevel is an integer from 1 to 12 inclusive for the Earth's elevation data and from 1 to 7 inclusive for the Moon's elevation data.

Examples

open allclose all

Basic Examples  (8)

Get the elevation above sea level at the current $GeoLocation:

In[1]:=
Click for copyable input
Out[1]=

Explicitly request metric units:

In[2]:=
Click for copyable input
Out[2]=

View the underlying expression:

In[3]:=
Click for copyable input
Out[3]//InputForm=

Plot the elevation around Denver, Colorado, using ReliefPlot:

In[1]:=
Click for copyable input
Out[1]=

Plot using ArrayPlot:

In[2]:=
Click for copyable input
Out[2]=

Show the elevation of Mount Everest as an entity:

In[1]:=
Click for copyable input
Out[1]=

The elevation of an entity is returned as a QuantityArray object (corresponding to an interpolation of elevations around the canonical entity position):

In[2]:=
Click for copyable input
Out[2]=

Return the height as a simple Quantity:

In[3]:=
Click for copyable input
Out[3]=

Elevation along the equator at 1° intervals of longitude:

In[1]:=
Click for copyable input
In[2]:=
Click for copyable input
Out[2]=

Draw the area around Mount Everest:

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=

By default, elevation is given with respect to the geoid, called orthometric elevation:

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=

Return geodetic elevation, with respect to the ellipsoid:

In[3]:=
Click for copyable input
Out[3]=

The difference is the so-called undulation (height of the geoid with respect to the ellipsoid) at that point:

In[4]:=
Click for copyable input
Out[4]=

By default, the elevation at a location is returned as a Quantity object:

In[1]:=
Click for copyable input
Out[1]=

Return a GeoPosition object with height information instead:

In[2]:=
Click for copyable input
Out[2]=

Elevation of the landing site of Apollo 11, in the Mare Tranquillitatis:

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=

Scope  (9)

Options  (3)

Applications  (7)

Properties & Relations  (4)

Possible Issues  (4)

Neat Examples  (2)

See Also

GeoGraphics  GeoPosition  ReliefPlot  ListContourPlot  ListDensityPlot  ListPlot3D  MountainData

Introduced in 2014
(10.0)
| Updated in 2017
(11.2)