USGS - science for a changing world

Cumulus Portal for Geospatial Data

Text-based Inventory Search Map-based Inventory Search Data.gov GOS Earth Explorer GloVis
ArcGIS Toolbar Online Mapping Services Bulk Data on Media Application Services
System Status Orthoimagery released in last 30 days Scheduled Data Releases
Frequently Asked Questions (FAQ) RSS Feed Technical Directions Contact Us
Elevation Query Web Service Method Documentation
Method Name getElevation
Description Returns a value from a single elevation source for a given latitude/longitude point
Method URL: http://cumulus.cr.usgs.gov/XMLWebServices/TNM_Elevation_Service.asmx?op=getElevation
Input Parameter: X_Value (Required) The longitude for the elevation request as decimal degrees (WGS 1984 Projection)
Input Parameter: Y_Value (Required) The latitude for the elevation request as decimal degrees (WGS 1984 Projection)
Input Parameter: Elevation_Units The units to return the elevation value in.
Valid arguments are:
FEET (default): Value is returned as US Feet
METERS: Value is returned in metric meters
Input Parameter: Source_Layer The source layer to use for the request. The *[Source Layer ID fragment] provides a method of restricting the best available datasets. IE: *NED will only use NED datasets, or *SRTM will only use SRTM datasets.
Valid arguments are:
Data SourceSource_Layer ID
(use this value)		Extent (West,South, East, North)
(default) Find the Best Available data at this point-1-180,-90,180,90
SRTM Contiguous South America 90-meter (3 arc_second) elevation dataSRTM.SA_3_ELEVATION-93.0000000022799,-55.9999999977599 to -32.0000000047199,14.9999999993999
SRTM Contiguous North America 90-meter (3 arc_second) elevation dataSRTM.NA_3_ELEVATION-180.000000005944,10.0000000008001 to 179.999999979387,60.9999999987549
SRTM.C_1TO19_3SRTM.C_1TO19_3-180.000000012589,42.0000000054 to 179.99999997275,60.00000000468
SRTM.C_20TO43_3SRTM.C_20TO43_3-179.000000007803,12.0000000044402 to 169.999999977999,42.0000000032401
SRTM.C_SA_3SRTM.C_SA_3-180.000000007038,-55.9999999942731 to 11.99999998515,30.00000000228
SRTM.C_AUS_3SRTM.C_AUS_3-38.9999999991601,-55.9999999964333 to 179.999999992079,14.0000000007598
SRTM Contiguous U. S. 30-meter (1 arc_second) elevation dataSRTM.C_US_1-180.0000000144,-15.0000000012 to -64.000000005144,61.00000000488
Tampa Bay Topobathy MetersNED.BATHY_TAMPA_BAY_ELEV_METERS-82.8750000000039,27.3749999992218 to -82.3750000000017,28.1249999992111
Delaware Bay Topobathy MetersNED.BATHY_DELAWARE_BAY_ELEV_METERS-75.4966666666296,38.7527777768336 to -74.858611111023,39.4458333324399
California Topobathy MetersNED.BATHY_CALIFORNIA_ELEV_METERS-124.979166666747,34.9169444435586 to -120.599722222299,38.9499999990807
Puget Sound Topobathy MetersNED.BATHY_PUGET_SOUND_ELEV_METERS-124.979166666747,34.9169444435586 to -120.599722222299,38.9499999990807
Afghanistan Digital Elevation ModelWEBMAP.AFGHANISTAN_DEM-123.16037037040032,47.043796296291 to -122.1996296295827,48.168055555640194
NED Alaska 2 arc second (15 minute) elevation dataNED.AK_NED-180.00333333334379,50.996666666667622 to -129.99666666663225,72.00333333335108
NED Contiguous U. S. 1 arc second elevation dataNED.CONUS_NED-125,23.9999999973783 to -65.9983333286253,49.9999999992314
NED Hawaii 1 arc-second elevation dataNED.HI_NED-161.0016666667,17.9983333327742 to -153.998333333366,23.0016666659869
NED Puerto Rico 1 arc-second elevation dataNED.PR_NED-68.0016666666668,16.9983333328051 to -63.9983333330132,19.0016666662453
NED US territories 1 arc-second elevation data (Islands with east longitude)NED.TI_E_NED133.9994444444,4.99944444427556 to 164.000555555645,16.0005555550985
NED US territories 1 arc-second elevation data (Islands with west longitude)NED.TI_W_NED-171.000555555605,-15.0005555550877 to -168.999444444485,-13.999444444001
NED Contiguous U. S. 1/3E arc second elevation dataNED.CONUS_NED_13E-99.00055555556,24.9994444436157 to -65.9994444443037,49.0005555546217
NED Contiguous U. S. 1/3W arc second elevation dataNED.CONUS_NED_13W-125.00055555557,25.9994444419356 to -98.9994444424024,49.000555554697
NED Hawaii 1/3rd arc-second elevation dataNED.HI_NED_13-161.00055555563,17.9994444438804 to -153.999444444485,23.0005555548894
NED US territories 1/3rd arc-second elevation data (Islands with east longitude)NED.TI_E_NED_13133.9994444444,4.99944444427556 to 164.000555555645,16.0005555550985
NED US territories 1/3rd arc-second elevation data (Islands with west longitude)NED.TI_W_NED_13-171.000555555605,-15.0005555550877 to -168.999444444485,-13.999444444001
NED Mount Saint Helens 1/9th arc-second elevation dataconus_NED_19_MSH-123.01299382719976,46.125000000000036 to -121.98700617287425,46.400000000001157
NED Puget Sound 1/9th arc-second elevation dataPGTSND_NED_19-125.010000000012,46.4899999990561 to -121.489999999997,48.5099999990705
NED Harris City 1/9th arc-second elevation dataHARRIS_CTY-95.999999999999957,29.470000000000034 to -94.874999999995126,30.220000000003267
NED Lincoln, NE 1/9th arc-second elevation dataLINCOLN_NE-96.886929999156592,40.617497603779 to -96.4858805843566,41.007559363379
NED West Virginia 1/9th arc-second elevation dataWESTVIRGINIA-83.000185185189991,36.999802029771907 to -79.999820566814307,38.500185185192592
Best Available Subset*[Source Layer ID fragment]Varies
Output Results string: XML Record Set containing records as shown below for the source layer
<Data_Source>[Source Layer]</Data_Source><Data_ID>[Source Layer ID]</Data_ID><Elevation>[Decimal Elevation Value]</Elevation><Units>[FEET or METERS]</Units>
[Decimal Elevation Value] = -1.79769313486231E+308 means no valid values were found at that point.


Method Name getAllElevations
Description Returns values from all elevation sources for a given latitude/longitude point
Method URL: http://cumulus.cr.usgs.gov/XMLWebServices/TNM_Elevation_Service.asmx?op=getAllElevations
Input Parameter: X_Value (Required) The longitude for the elevation request as decimal degrees (WGS 1984 Projection)
Input Parameter: Y_Value (Required) The latitude for the elevation request as decimal degrees (WGS 1984 Projection)
Input Parameter: Elevation_Units The units to return the elevation value in.
Valid arguments are:
FEET (default): Value is returned as US Feet
METERS: Value is returned in metric meters
Output Results string: XML Record Set containing records as shown below for each source layer
<Data_Source>[Source Layer]</Data_Source><Data_ID>[Source Layer ID]</Data_ID><Elevation>[Decimal Elevation Value]</Elevation><Units>[FEET or METERS]</Units>
[Decimal Elevation Value] = -1.79769313486231E+308 means no valid values were found at that point.

See Also:
Elevation Query Web Service Overview

Accessibility FOIA Privacy Policies and Notices

Take Pride in America logo USA.gov logo U.S. Department of the Interior | U.S. Geological Survey
URL: http://cumulus.cr.usgs.gov/includes/footer_xml.php
Page Contact Information: webmapping@usgs.gov
Page Last Modified: January 26, 2012