Package pygeodesy :: Module elevations
[frames] | no frames]

Module elevations

Functions to obtain elevations and geoid heights thru web services, for (lat, lon) locations, currently limited to the Conterminous US (CONUS).

macOS: If an SSLCertVerificationError occurs, especially this "[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self "signed certificate in certificate chain ...", review this post for a remedy. From a Terminal window run: "/Applications/Python X.Y/Install Certificates.command"


Version: 18.10.04

Functions
 
elevation2(lat, lon, timeout=2.0)
Get the geoid elevation at an NAD83 to NAVD88 location.
 
geoidHeight2(lat, lon, model=0, timeout=2.0)
Get the NAVD88 geoid height at an NAD83 location.
Function Details

elevation2(lat, lon, timeout=2.0)

 

Get the geoid elevation at an NAD83 to NAVD88 location.

Parameters:
  • lat - Latitude (degrees).
  • lon - Longitude (degrees).
  • timeout - Optional, query timeout (seconds).
Returns:
2-Tuple (elevation, data_source) in (meter, str) or (None, <error>).

Note: The returned elevation is None if lat or lon is invalid or outside the Conterminous US (CONUS), if conversion failed or if the query timed out. The <error> is the HTTP-, IO-, SSL-, Type-, URL- or ValueError as str.

See Also: USGS National Map, the FAQ and USGS10mElev.py.

geoidHeight2(lat, lon, model=0, timeout=2.0)

 

Get the NAVD88 geoid height at an NAD83 location.

Parameters:
  • lat - Latitude (degrees).
  • lon - Longitude (degrees).
  • model - Optional, geoid model ID (int).
  • timeout - Optional, query timeout (seconds).
Returns:
2-Tuple (height, model_name) in (meter, str) or (None, <error>).

Note: The returned height is None if lat or lon is invalid or outside the Conterminous US (CONUS), if the model was invalid, if conversion failed or if the query timed out. The <error> is the HTTP-, IO-, SSL-, Type-, URL- or ValueError as str.

See Also: NOAA National Geodetic Survery and Geoid