USGS - science for a changing world

GISDATA Map Studio

spacer image
Gazetteer Query Web Service Method Documentation
Method Name searchName
Description Returns an XML data list of places that have a matching Name
Method URL: http://gisdata.usgs.net/XMLWebServices/TNM_Gazetteer_Service.asmx?op=searchName
Input Parameter: PlaceName (Required) A String to search for in the Name field of the GNIS data
Input Parameter: PlaceType (Required) A string to specify the type of GNIS data. (IE: "PPL" will search only for populated places.) Possible Values: airport,arch,area,arroyo,bar,basin,bay,beach,bench,bend,bridge,
   building,canal,cape,cemetery,census,channel,church,civil,cliff,crater,crossing,dam,falls,flat,forest,gap,geyser,glacier,gut,harbor,hospital,island,isthmus,lake,lava,levee,locale,military,mine,oilfield,
   other,park,pillar,plain,po,ppl,ppl_100k,range,rapids,reserve,reservoir,ridge,school,sea,slope,spring,stream,summit,swamp,tower,trail,tunnel,unknown,valley,well,woods
Input Parameter: inNumRecords (Optional) An integer between 1 and 200 that defines how many records to return in the result set. This defaults to 20.
Input Parameter: inFirstRecord (Optional) An integer that defines the position in the result set to allow for paging when there are more than NumRecords results. This defaults to 1.
Output Results string: XML Record Set containing records as shown in the example below for the identified station
  or
[Error Description] if a problem was encountered, like a bad PlaceName, PlaceType, or if the service was unable to find any matches.


Method Name showGazetteerData
Description Returns the Gazetteer data at given latitude/longitude point for a specified type
Method URL: http://gisdata.usgs.net/XMLWebServices/TNM_Gazetteer_Service.asmx?op=showGazetteerData
Input Parameter: X_Value (Required) The longitude for the gazetteer request as decimal degrees (WGS 1984 Projection)
Input Parameter: Y_Value (Required) The latitude for the gazetteer request as decimal degrees (WGS 1984 Projection)
Input Parameter: PlaceType (Required) A string to specify the type of GNIS data. (IE: "PPL" will search only for populated places.) Possible Values: airport,arch,area,arroyo,bar,basin,bay,beach,bench,bend,bridge,
   building,canal,cape,cemetery,census,channel,church,civil,cliff,crater,crossing,dam,falls,flat,forest,gap,geyser,glacier,gut,harbor,hospital,island,isthmus,lake,lava,levee,locale,military,mine,oilfield,
   other,park,pillar,plain,po,ppl,ppl_100k,range,rapids,reserve,reservoir,ridge,school,sea,slope,spring,stream,summit,swamp,tower,trail,tunnel,unknown,valley,well,woods
Input Parameter: inNumRecords (Optional) An integer between 1 and 200 that defines how many records to return in the result set. This defaults to 20.
Input Parameter: inFirstRecord (Optional) An integer that defines the position in the result set to allow for paging when there are more than NumRecords results. This defaults to 1.
Output Results string: [X Value],[Y Value] OR string: ERROR: [Error Description]


Method Name searchLocalName
Description Returns the Gazetteer data at given latitude/longitude point for a specified type
Method URL: http://gisdata.usgs.net/XMLWebServices/TNM_Gazetteer_Service.asmx?op=searchLocalName
Input Parameter: Min_X_Value (Required) The smallest longitude for a specified extent to restrict the search area in decimal degrees (WGS 1984 Projection)
Input Parameter: Min_Y_Value (Required) The smallest latitude for a specified extent to restrict the search area in decimal degrees (WGS 1984 Projection)
Input Parameter: Max_X_Value (Required) The largest longitude for a specified extent to restrict the search area in decimal degrees (WGS 1984 Projection)
Input Parameter: Max_Y_Value (Required) The largest latitude for a specified extent to restrict the search area in decimal degrees (WGS 1984 Projection)
Input Parameter: PlaceName (Required) A String to search for in the Name field of the GNIS data
Input Parameter: PlaceType (Required) A string to specify the type of GNIS data. (IE: "PPL" will search only for populated places.) Possible Values: airport,arch,area,arroyo,bar,basin,bay,beach,bench,bend,bridge,
   building,canal,cape,cemetery,census,channel,church,civil,cliff,crater,crossing,dam,falls,flat,forest,gap,geyser,glacier,gut,harbor,hospital,island,isthmus,lake,lava,levee,locale,military,mine,oilfield,
   other,park,pillar,plain,po,ppl,ppl_100k,range,rapids,reserve,reservoir,ridge,school,sea,slope,spring,stream,summit,swamp,tower,trail,tunnel,unknown,valley,well,woods
Input Parameter: inNumRecords (Optional) An integer between 1 and 200 that defines how many records to return in the result set. This defaults to 20.
Input Parameter: inFirstRecord (Optional) An integer that defines the position in the result set to allow for paging when there are more than NumRecords results. This defaults to 1.
Output Results string: [X Value],[Y Value] OR string: ERROR: [Error Description]

See Also:
Gazetteer 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