| Method Name |
searchName |
| Description |
Returns an XML data list of places that have a matching Name |
| Method URL: |
http://cumulus.cr.usgs.gov/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://cumulus.cr.usgs.gov/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://cumulus.cr.usgs.gov/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
|
U.S. Department of the Interior |
U.S. Geological Survey