USGS - science for a changing world

GISDATA Map Studio

spacer image
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://gisdata.usgs.gov/XMLWebServices2/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 3 arc-second: All Northern Latitudes SRTM_3SEC_GLOBAL_ELEV_NORTH-180.000000012589,42.0000000054 to 179.99999997275,60.00000000468
SRTM 3 arc-second: Middle Latitudes SRTM_3SEC_GLOBAL_ELEV_CENTRAL-179.000000007803,12.0000000044402 to 169.999999977999,42.0000000032401
SRTM 3 arc-second: Southern Africa, Australia, SE Asia SRTM_3SEC_GLOBAL_ELEV_SOUTHEAST-38.9999999991601,-55.9999999964333 to 179.999999992079,14.0000000007598
SRTM 3 arc-second: Central and South America, Western Africa, Pacific Islands SRTM_3SEC_GLOBAL_ELEV_SOUTHWEST-180.000000007038,-55.9999999942731 to 11.99999998515,30.00000000228
SRTM 1 arc-second: Contiguous U.S. SRTM_1SEC_ELEV_US-180.0,-15.00 to 180.0,60.00
NED 2 arc-second: AlaskaNED.AK_NED-180.00333333334379,50.996666666667622 to -129.99666666663225,72.00333333335108
NED 1 arc-second: Alaska North SlopeNED_AK_1AS-159.0016666667,67.9983656174 to -149.9984307324,72.0017484139
NED 1 arc-second: Contiguous United StatesNED.CONUS_NED-125,23.9999999973783 to -65.9983333286253,49.9999999992314
NED 1 arc-second: HawaiiNED.HI_NED-161.0016666667,17.9983333327742 to -153.998333333366,23.0016666659869
NED 1 arc-second: Puerto RicoNED.PR_NED-68.0016666666668,16.9983333328051 to -63.9983333330132,19.0016666662453
NED 1 arc-second: U.S. Territorial Islands with east longitudeNED.TI_E_NED133.9994444444,4.99944444427556 to 164.000555555645,16.0005555550985
NED 1 arc-second: U.S. Territorial Islands with west longitudeNED.TI_W_NED-171.000555555605,-15.0005555550877 to -168.999444444485,-13.999444444001
NED 1/3rd arc-second: Eastern United StatesNED.CONUS_NED_13E-99.00055555556,24.9994444436157 to -65.9994444443037,49.0005555546217
NED 1/3rd arc-second: Western United StatesNED.CONUS_NED_13W-125.00055555557,25.9994444419356 to -98.9994444424024,49.000555554697
NED 1/3rd arc-second: Alaska North SlopeNED.AK_NED_13-159.0,68.0 to -150.0,72.0
NED 1/3rd arc-second: HawaiiNED.HI_NED_13-161.00055555563,17.9994444438804 to -153.999444444485,23.0005555548894
NED 1/3rd arc-second: U.S. Territorial Islands with east longitudeNED.TI_E_NED_13133.9994444444,4.99944444427556 to 164.000555555645,16.0005555550985
NED 1/3rd arc-second: U.S. Territorial Islands with west longitudeNED.TI_W_NED_13-171.000555555605,-15.0005555550877 to -168.999444444485,-13.999444444001
NED 1/9th arc-second: Kenai, AlaskaElev_AK_Kenai-151.416091,60.489848 to -150.482042,61.006746
NED 1/9th arc-second: Valdez, AlaskaElev_AK_Valdez-146.8134180015,60.9989665178 to -145.6874919855,61.2505097478
NED 1/9th arc-second: Alabama-Louisiana-Mississippi CoastElev_AL_LA_MS_Coast-94.000191377,28.9998020279 to -87.4998185067,32.0001975477
NED 1/9th arc-second: Lukeville, ArizonaElev_AZ_Lukeville-114.6555352444,31.834782844 to -112.6855042226,32.499906354
NED 1/9th arc-second: Arizona-Mexico Border (Central)Elev_AZ_MX_Border_Central-114.0115316871,31.2469720034 to -111.0598647843,32.2911696178
NED 1/9th arc-second: Arizona-Mexico Border (Eastern)Elev_AZ_MX_Border_East-111.0841397757,31.2840198153 to -108.5404358685,31.3478161167
NED 1/9th arc-second: Arizona-Mexico Border (Western)Elev_AZ_MX_Border_West-114.8663844738,32.1935198041 to -113.9861374898,32.7746000975
NED 1/9th arc-second: Nogales, Arizona (Eastern)Elev_AZ_NogalesEast-109.8516048344,31.2324015559 to -108.5528701626,31.4365065105
NED 1/9th arc-second: Nogales, Arizona (Western)Elev_AZ_NogalesWest-111.0723646669,31.3284372485 to -110.0222411261,31.4366779979
NED 1/9th arc-second: Sasabe, ArizonaElev_AZ_Sasabe-112.7037916728,31.3196036288 to -111.0369396876,31.8970419466
NED 1/9th arc-second: Alameda, CaliforniaElev_CA_Alameda-122.3520345333,37.4539514444 to -121.4637011289,37.9138897528
NED 1/9th arc-second: Canyon Fire, CaliforniaElev_CA_CanyonFire-118.7233877837,34.0256729124 to -118.6316902455,34.0841914356
NED 1/9th arc-second: Day Fire, CaliforniaElev_CA_DayFire-118.9962873203,34.4566533531 to -118.6355465507,34.7160052257
NED 1/9th arc-second: California-Mexico Border 1Elev_CA_MX_Border-117.1281781932,32.4549946235 to -114.7804310918,32.7451489677
NED 1/9th arc-second: California-Mexico Border 2Elev_CA_MX_Border_2-117.1454413392,32.5308894372 to -115.7868918478,32.7567227886
NED 1/9th arc-second: Poway, CaliforniaElev_CA_Poway-117.0845670198,32.9269844135 to -116.9400917111,33.0666757715
NED 1/9th arc-second: Sacramento, CaliforniaElev_CA_Sacramento-121.5729010839,38.3817749922 to -121.1849072509,38.7400465968
NED 1/9th arc-second: San Diego, CaliforniaElev_CA_SanDiego-117.2836500385,32.5322214134 to -116.9051932181,33.118270843
NED 1/9th arc-second: Denver, ColoradoElev_CO_Denver-105.3217533293,39.5282126507 to -104.4799940027,40.0156818255
NED 1/9th arc-second: Sussex County, DelawareElev_DE_SussexCounty-75.7226850645,38.4498915766 to -75.0354936515,38.9617743336
NED 1/9th arc-second: Escambia County, FloridaElev_FL_EscambiaCounty-87.6433148502,30.2783906166 to -86.8293025045,31.0074029623
NED 1/9th arc-second: Northern Jefferson County, FloridaElev_FL_JeffersonCountyNorth-84.0947513383,30.2836715352 to -83.5858006803,30.6937950248
NED 1/9th arc-second: Lake County, FloridaElev_FL_LakeCounty-81.9641403287,28.3331248177 to -81.3476279335,29.2836495851
NED 1/9th arc-second: Northwest Florida Water Management DistrictElev_FL_NWFWMD-86.043194143,30.0296175491 to -84.3039656089,31.006592936
NED 1/9th arc-second: Okaloosa County, FloridaElev_FL_OkaloosaCounty-87.0001851852,29.999814814 to -85.9998148148,31.5001851844
NED 1/9th arc-second: Santa Rosa County, FloridaElev_FL_SantaRosaCounty-87.3239216684,30.3422696426 to -86.7758969332,31.0084733996
NED 1/9th arc-second: Southwest Florida Water Management DistrictElev_FL_SWFWMD-82.657791913,27.5100044198 to -81.5081621915,28.6389242631
NED 1/9th arc-second: Volusia County, FloridaElev_FL_VolusiaCounty-81.5738731554,28.6115898068 to -80.7269904393,29.4281638809
NED 1/9th arc-second: Walton County, FloridaElev_FL_WaltonCounty-86.4075220361,30.2623789634 to -85.8230775449,31.002749393
NED 1/9th arc-second: Potato Creek, GeorgiaElev_GA_PotatoCreek-84.453536,32.782067 to -84.160755,33.250355
NED 1/9th arc-second: Miscellaneous Areas in IdahoElev_ID_MiscAreas-116.8176830356,42.5832927936 to -111.3889171692,47.5700215876
NED 1/9th arc-second: Boone County, IllinoisElev_IL_BooneCounty-88.9430893038,42.1523596559 to -88.704385581,42.4960325229
NED 1/9th arc-second: Winnebago County, IllinoisElev_IL_WinnebagoCounty-89.4056871447,42.1481140585 to -88.9331871067,42.5004597657
NED 1/9th arc-second: Fort Riley, KansasElev_KS_FortRiley-96.9803755376,39.0257218869 to -96.6646965,39.3163391941
NED 1/9th arc-second: Johnson County, KansasElev_KS_JohnsonCounty-95.0663453598,38.7039869561 to -94.5999255694,39.0649746394
NED 1/9th arc-second: Kansas River, KansasElev_KS_KansasRiver-96.906533698,38.7302997656 to -94.588323636,39.4232319198
NED 1/9th arc-second: Southern Leavenworth County, KansasElev_KS_LeavenworthCountySouth-95.194363,38.947068 to -94.904803,39.027022
NED 1/9th arc-second: Sedgwick County, KansasElev_KS_SedgwickCounty-97.808371,37.474182 to -97.098448,37.912610
NED 1/9th arc-second: LouisianaElev_LA_State-94.0735949731,29.0383552307 to -89.0942735871,33.0670592567
NED 1/9th arc-second: Augusta, MaineElev_ME_Augusta-69.9273792204,44.2540251667 to -69.6084594418,44.4035004873
NED 1/9th arc-second: Southwest Coastline, MaineElev_ME_SouthwestCoastline-70.8427542352,43.0529783193 to -69.8419825498,43.9800462947
NED 1/9th arc-second: Baltimore, MarylandElev_MD_Baltimore-76.714041108,39.1957071463 to -76.5265102288,39.3727133333
NED 1/9th arc-second: Baltimore County, MarylandElev_MD_BaltimoreCounty-76.321039748,39.1939846161 to -76.321039748,39.7223488559
NED 1/9th arc-second: Central and Eastern MarylandElev_MD_CentralAndEast-77.2935053066,37.9096236032 to -75.0254569502,39.7289505766
NED 1/9th arc-second: Eastern Areas in MarylandElev_MD_EasternAreas-76.277731,38.729729 to -75.699333,39.372299
NED 1/9th arc-second: Juarez, MexicoElev_MX_Juarez-106.638783361,31.4748564422 to -106.215635179,31.7840231336
NED 1/9th arc-second: Minnesota-North Dakota BorderElev_MN_ND_Border-97.73661,46.35916 to -96.08243,49.05173
NED 1/9th arc-second: Red River, MinnesotaElev_MN_RedRiver-97.24629,46.32519 to -95.21825,49.00004
NED 1/9th arc-second: Carroll, Chariton, Lafayette, and Saline Counties, MissouriElev_MO_CarrollCharitonLafayetteSalineCounties-94.118688,38.906512 to -92.687331,39.708472
NED 1/9th arc-second: Cass County, MissouriElev_MO_CassCounty-94.6155159863,38.4442430463 to -94.0632319915,38.8487183873
NED 1/9th arc-second: Jackson County, MissouriElev_MO_JacksonCounty-94.6167342191,38.8273278146 to -94.0991724493,39.238037724
NED 1/9th arc-second: Mississippi-Missouri-Illinois RiversElev_MS_MO_IL_Rivers-97.5001851852,35.9998148139 to -87.9998148148,45.0001851843
NED 1/9th arc-second: Lincoln, NebraskaElev_NE_Lincoln-96.8869299992,40.6174976028 to -96.4858805844,41.0075593624
NED 1/9th arc-second: Camden, New JerseyElev_NJ_Camden-75.1498162299,39.5334499036 to -74.3830260451,40.1922771168
NED 1/9th arc-second: Gloucester County, New JerseyElev_NJ_GloucesterCounty-75.42794,39.51212 to -74.87669,39.88451
NED 1/9th arc-second: Northeastern New JerseyElev_NJ_Northeast-74.6251068115,40.2494316092 to -73.9012179226,41.2049871647
NED 1/9th arc-second: North CarolinaElev_NC_State-84.3160108891,33.8406637681 to -75.4613195399,36.5828859876
NED 1/9th arc-second: Southeastern North DakotaElev_ND_Southeast-98.086231,45.590884 to -96.711607,46.499336
NED 1/9th arc-second: Walsh County, North DakotaElev_ND_WalshCounty-98.32075,48.01237 to -97.54317,48.55670
NED 1/9th arc-second: Northern OhioElev_OH_North-85.00019,39.49981 to -79.99981,42.00019
NED 1/9th arc-second: Sallisaw, OklahomaElev_OK_Sallisaw-94.9524321681,35.4222253303 to -94.6159506596,35.8121944973
NED 1/9th arc-second: Deschutes River, OregonElev_OR_DeschutesRiver-122.03093,43.46196 to -120.63080,45.63592
NED 1/9th arc-second: Oregon City, OregonElev_OR_OregonCity-122.6617280841,45.2875771485 to -122.5170984429,45.3894290085
NED 1/9th arc-second: Portland, OregonElev_OR_Portland-123.2555734667,45.1977610685 to -122.6229190951,45.9049833473
NED 1/9th arc-second: Sandy River, OregonElev_OR_SandyRiver-122.4255309074,45.3703191082 to -122.1034938447,45.5746709764
NED 1/9th arc-second: South Fork John Day River, OregonElev_OR_SouthForkJohnDayRiver-119.6581786709,44.166313266 to -119.3624070423,44.4829182296
NED 1/9th arc-second: Northern South CarolinaElev_SC_North-82.33146,33.17728 to -79.06691,35.18652
NED 1/9th arc-second: Lincoln and Minnehaha Counties, South DakotaElev_SD_MinnehahaLincolnCounties-97.12955,43.06334 to -96.43056,43.84949
NED 1/9th arc-second: Missouri River, South DakotaElev_SD_MissouriRiver-100.3691158618,43.0383073468 to -98.508283616,44.3582139831
NED 1/9th arc-second: Aransas and Refugio Counties, TexasElev_TX_AransasRefugioCounties-97.5387651332,27.812484512 to -96.7888885296,28.5625154362
NED 1/9th arc-second: Brazoria County, TexasElev_TX_BrazoriaCounty-95.8750154671,28.8208796004 to -95.0469598453,29.6034413915
NED 1/9th arc-second: Cameron County, TexasElev_TX_CameronCounty-97.87019,25.82873 to -97.13626,26.49997
NED 1/9th arc-second: Chambers County, TexasElev_TX_ChambersCounty-94.9870112096,29.499984541 to -94.3509309119,29.9062500056
NED 1/9th arc-second: Galveston County, TexasElev_TX_GalvestonCounty-95.2344311171,29.0833796215 to -94.3687211714,29.5998920085
NED 1/9th arc-second: Harris County, TexasElev_TX_HarrisCounty-96.00,29.4699999992 to -94.875,30.2199999992
NED 1/9th arc-second: Jackson, Matagorda, and Victoria Counties, TexasElev_TX_JacksonMatagordaVictoriaCounties-97.305602,28.386358 to -95.499985,29.267993
NED 1/9th arc-second: Jefferson County, TexasElev_TX_JeffersonCounty-94.4687651517,29.5604783389 to -93.8332712737,30.2187499965
NED 1/9th arc-second: Kenedy and Kleberg Counties, TexasElev_TX_KenedyKlebergCounties-98.0660093933,26.5914571214 to -97.2179229061,27.6446670821
NED 1/9th arc-second: Texas-Mexico Border NorthElev_TX_MX_Border1-100.9326407313,28.7334591071 to -100.4727024229,29.3395085383
NED 1/9th arc-second: Texas-Mexico Border SouthElev_TX_MX_Border2-100.5435282004,27.5622726489 to -99.5476021948,28.6968406409
NED 1/9th arc-second: Orange County, TexasElev_TX_OrangeCounty-94.125015,29.966451 to -93.687482,30.250015
NED 1/9th arc-second: San Patricio County, TexasElev_TX_SanPatricioCounty-97.910509,27.812485 to -97.132423,28.187546
NED 1/9th arc-second: Iron County, UtahElev_UT_IronCounty-113.201567,37.621018 to -112.802064,37.882704
NED 1/9th arc-second: Salt Lake City, UtahElev_UT_SaltLakeCity-112.0272069,40.5705428599 to -111.8231328096,40.9043700471
NED 1/9th arc-second: Wasatch County, UtahElev_UT_WasatchCounty-111.507655,40.333920 to -111.282213,40.616041
NED 1/9th arc-second: Chittenden County, VermontElev_VT_ChittendenCounty-73.3102052565,44.2623421303 to -72.8075508953,44.7301199455
NED 1/9th arc-second: Essex County, VermontElev_VT_EssexCounty-72.0130308669,44.338706957 to -71.4090493374,45.0423181244
NED 1/9th arc-second: Lake Roosevelt, WashingtonElev_WA_LakeRoosevelt-118.2336339447,48.47905669 to -117.7202079777,48.9570814196
NED 1/9th arc-second: Mount Saint Helens, WashingtonElev_WA_MtStHelens-123.0129938272,46.1249999991 to -121.9870061729,46.3999999991
NED 1/9th arc-second: Northwest WashingtonElev_WA_Northwest-122.8239294251,48.2923610327 to -121.0368613801,49.0107561519
NED 1/9th arc-second: Puget Sound, WashingtonElev_WA_PugetSound-125.01,46.4899999991 to -121.49,48.5099999991
NED 1/9th arc-second: West VirginiaElev_WV_State-83.000185185189991,36.999802029771907 to -77.4998148147981,41.0001851851992
NED 1/9th arc-second: Snake River, WyomingElev_WY_SnakeRiver-110.77216,43.62502 to -110.46733,43.87395
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://gisdata.usgs.gov/XMLWebServices2/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://gisdata.usgs.gov/
Page Contact Information: webmapping@usgs.gov
Page Last Modified: October 2005