Web Soil Survey URL Query Parameters
Below are examples of pre-defined URL addresses you can create and
incorporate into eFOTG, web pages, applications, or provide to another
person to use. Some of the following parameters set a specific area of
interest (AOI) while others only zoom to a specific area but do not set the
AOI. For more general information about using Web Soil Survey, please go to
Web Soil Survey and refer to the items on the right-side of the page under
“I Want To ...” and the “I Want Help With ...” sections.
Note: All longitude and latitude coordinates are assumed to be specified
with reference to the WGS84
spatial reference (spatial reference ID
EPSG:4326).
aoissa
The aoissa specifies an
AOI set to the specified soil survey area,
designated by its area ID. For example,
http://websoilsurvey.nrcs.usda.gov/app/WebSoilSurvey.aspx?aoissa=NC175
sets your
AOI to the Transylvania County, North Carolina soil survey area.
If your
AOI is already set to the specified soil survey area, Web Soil
Survey recognizes this and does not re-set your
AOI. To see a list of all
published soil survey area ids go into
Web Soil Survey and choose the “Soil
Survey Area” link beneath “Quick Navigation” on the left-side of the screen.
Choose a state from the drop-down menu and you will get a list of all area
symbols which may be used with the aoissa parameter.
aoicoords
The aoicoords query parameter specifies an
AOI as a polygon. Each pair of
coordinates consists of a longitude and a latitude. The list of coordinates
specifies a single POLYGON in the
Well-Known Text format. For example,
http://websoilsurvey.nrcs.usda.gov/app/WebSoilSurvey.aspx?aoicoords=((-98.20956
46.44914,-98.1925 46.44903,-98.19231 46.46183,-98.20937 46.46195,-98.20956
46.44914))
sets your
AOI to the specified polygon.
If your
AOI is already set to the specified polygon, the application
recognizes this and does not re-set your
AOI.
location
The location query parameter indicates where the map is to be zoomed,
specifying the map extent by means of two opposite corners of the map,
either north-west and south-east or south-west and north-east. The parameter
value is two pairs of coordinates, each consisting of a longitude and
latitude, specifying a MULTIPOINT in the
Well-Known Text format. For
example,
http://websoilsurvey.nrcs.usda.gov/app/WebSoilSurvey.aspx?location=(-82.23245
39.24656,-80.67047 38.50137)
zooms the map to the specified location.
If the map is already zoomed to the specified location, the application
recognizes this and does not re-draw the map. If location is specified along
with aoissa or aoicoords, the map zooms to the specified location and not to
the
AOI.
marker
The marker query parameter specifies a point to be marked on the map with
the location marker icon:. The parameter value is a pair of coordinates,
consisting of a longitude and latitude, specifying a POINT in the
Well-Known
Text format. For example,
http://websoilsurvey.nrcs.usda.gov/app/WebSoilSurvey.aspx?marker=(-84.60032
46.23243)
displays the location marker icon at the specified point.
viewextent
The viewextent query parameter sets the view extent that the map zooms to
when you press the “Zoom to Full Extent” map tool. The parameter value is
the name of the view extent, as it appears in the View Extent map control.
For example,
http://websoilsurvey.nrcs.usda.gov/app/WebSoilSurvey.aspx?viewextent=Alaska
sets the view extent to Alaska.
If viewextent is specified without location, aoicoords, or aoissa, the map
also zooms to the new view extent. Extents available are: Contiguous U.S.,
Alaska, Hawaii, Pacific Basin, American Samoa, Federated States of
Micronesia, Guam, Marshall Islands, Palau, Northern Mariana Islands, Puerto
Rico, Virgin Islands.
Note: It is not possible to use the viewextent parameter to go directly to a
county. The options available for going directly to a county are: 1) to use
the marker parameter with the latitude/longitude of the center of the county
to direct a user to a specific county. It will be up to the user to create
an
AOI. 2) to use aoissa parameter and set the
AOI to the soil survey area
with the understanding that there is not a one to one correlation between a
county and a soil survey area. Some soil survey areas do happen to be a
single county but often times they are multiple counties or parts of
multiple counties.
|