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 (the surface of constant gravitational potential equal to that of 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, or an array of them
    "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:
  • Background0background value to use for missing data
    GeoArraySizeAutomaticarray dimensions of the result
    GeoCenterAutomaticcenter coordinates to use
    GeoGridRangeAllprojected coordinate range to include
    GeoGridRangePaddingAutomatichow much to pad the projected range
    GeoModelAutomaticmodel of the Earth (or other body) to use
    GeoProjection"Equirectangular"projection to use
    GeoRangeAutomaticgeographic area range to include
    GeoRangePaddingAutomatichow much to pad the geographic range
    GeoResolutionAutomaticgeo distance between neighboring values
    GeoZoomLevelAutomaticlevel of resolution of the elevation array
    UnitSystem$UnitSystemunit system in which to return elevations
  • The options GeoRange, GeoCenter and GeoRangePadding refer to the {lat,lon} coordinate ranges on the Earth's surface. The options GeoGridRange and GeoGridRangePadding refer to projected coordinate ranges on the flat map.
  • The original elevation data is stored in "Equirectangular" projection. For other projections, the result is obtained by bilinear interpolation of the equirectangular data.
  • The following settings for UnitSystem can be used:
  • "Imperial"return results in imperial units
    "Metric"return results in metric units
  • GeoElevationData[, GeoModelbody] gives elevation for a location or region on the Moon, Mars or other solid planetary body.
  • The spatial resolution of the requested elevation data can be selected with GeoResolutionresol, where resol is a Quantity distance, or with GeoZoomLevelzoom, where zoom is a positive integer. These are the maximum zoom levels available for each celestial body and their corresponding resolutions at the equator:
  • "Earth"max zoom 12resolution
    "Mars"max zoom 7resolution
    "Mercury"max zoom 6resolution
    "Moon"max zoom 8resolution
    "Pluto"max zoom 5resolution

Examples

open all close 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=

Get the elevation above sea level at the location of Mount Everest:

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

The interpolated result is lower than the actual elevation at the peak:

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

Get an array of elevations for a region of 4 kilometers of radius around Mount Everest:

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

Compute the minimum and maximum values in that region:

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

Plot the array of elevations as a 3D surface:

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

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]=

Elevation along the equator at 1° intervals of longitude:

In[1]:=
Click for copyable input
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
In[2]:=
Click for copyable input
Out[2]=
In[3]:=
Click for copyable input
Out[3]=

Return geodetic elevation, with respect to the ellipsoid:

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

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

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

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  (8)

Options  (12)

Applications  (7)

Properties & Relations  (4)

Possible Issues  (3)

Neat Examples  (2)

Introduced in 2014
(10.0)
|
Updated in 2019
(12.0)