Soil Data Access WMS 1.3.0 & WFS 2.0.0 Web Services Help
The following web services are available:
- https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS
- https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WFS
The current Soil Data Access Web Map Service (WMS) supports Open Geospatial Consortium (OGC) WMS version 1.3.0 requests while the current Soil Data Access Web Feature Services (WFS) support OGC WFS version 2.0.0 (GML2/GML3) requests. GML is an acronym for Geography Markup Language, and is the XML grammar defined by the Open Geospatial Consortium (OGC) to express geographical features. GML serves as a modeling language for geographic systems as well as an open interchange format for geographic transactions on the Internet. EPSG is an acronym used throughout the Soil Data Access web pages. It stands for European Petroleum Survey Group. They publish a database of coordinate system information plus some very good related documents on map projections and datums.
The current Soil Data Access WMS service is supported by the following ArcGIS Pro versions:
- ArcGIS PRO 3.x
- ArcGIS PRO 2.x
- ArcGIS PRO 1.4
The current Soil Data Access WMS service is supported by the following ArcGIS Desktop versions:
- ArcGIS 10.8
The current Soil Data Access WMS services are supported by the following ArcGIS Enterprise versions:
- ArcGIS Enterprise 10.6
- ArcGIS Enterprise 10.5
The current Soil Data Access WFS services are supported by the following ArcGIS Enterprise versions:
- ArcGIS Enterprise 11.x
- ArcGIS Enterprise 10.9
- ArcGIS Enterprise 10.8
- ArcGIS Enterprise 10.7
- ArcGIS Enterprise 10.6
- ArcGIS Enterprise 10.5
For other products that support the current Soil Data Access web map service or web feature services, please visit https://portal.ogc.org/public_ogc/compliance/compliant.php and select specification "Web Map Service v.1.3.0" or "Web Feature Service v.2.0.0", respectively. For instructions for integrating the Soil Data Access web services into your Geographical Information System (GIS) or other related product, please refer to your vendor's documentation.
The following conventions are used when describing all web service method input parameters:
{} = required parameter
[] = optional parameter
| = "or" (separates alternatives)
<label> = variable or definition block
parameter names and values are case insensitive
Web Services
https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WFS
This service returns features in Web Mercator (EPSG 3857) and WGS 84 (EPSG 4326) coordinates. Input parameters for the GetFeature method include one or more spatial filters and the name of the feature type or layer that should be returned. The volume of information that can be returned by a GetFeature request is constrained by limiting the extent of any input spatial filter.
Methods: GetCapabilities, DescribeFeatureType, GetFeature
https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS
This service returns map images in common image formats such as JPEG, GIF, PNG, and others. Input parameters for the GetMap method include projection, image width and height in pixels, a single bounding box spatial filter, the names of the feature types or layers that should be returned and image format. The volume of information that can be returned by a GetMap request is constrained by limiting the extent of the input spatial filter.
Methods: GetCapabilities, DescribeLayer, GetStyles, GetFeatureInfo, GetMap
To add this service to ArcMap: Click "Add Data", then "GIS Servers", then "Add WMS Server". For the URL, type the web service URL without any query string parameters, such as https://SDMDataAccess.sc.egov.usda.gov/Spatial/SDM.wms?. Click OK. Click Add. Select the Soil Data Mart Data Access Web Map Service. Click Add. The layers have maximum and minimum scale thresholds for visibility so you may need to zoom in to see a map.
Web Service Methods
GetCapabilities
This method returns information about the corresponding web service. This information includes supported methods, supported feature types or layers, supported spatial filters and supported projection(s).
Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WFS
Input parameters:
[ VERSION=1.3.0 ] : OGC version number when SERVICE=WMS
[ VERSION=2.0.0 ] : OGC version number when SERVICE=WFS
{ REQUEST=GetCapabilities } : method name
DescribeFeatureType
This method returns information about the feature types or layers supported by the corresponding web service. This information includes geometry type, attribute names and data types. Thematic map feature types are supported only by the Web Mercator (SDMWM.wfs) service.
Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WFS
Input parameters:
[ VERSION=2.0.0 ] : OGC version number
{ REQUEST=DescribeFeatureType } : method name
[ TYPENAME=<layer name> ] : feature type or layer name (default = all feature types or layers)
[ OUTPUTFORMAT=XMLSCHEMA | SFE_XMLSCHEMA ] : output format (default = XMLSCHEMA)
GetStyles
This method returns a "Styled Layer Descriptor" (SLD) for the specified layer(s) as an XML file. The SLD may be edited and used in conjunction with a GetMap "SLD_BODY" request to tailor the appearance of a map. SLD is documented at Mapserver SLD. Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS
Input parameters:
[ VERSION=1.3.0 ] : OGC version number
{ REQUEST=GetStyles } : method name
[ LAYERS=<layer name list> ] : feature type or layer name(s), comma-separated
GetFeature
This method returns a feature collection for a single feature type or layer, for a user specified area of interest. Spatial data are returned only for OUTPUTFORMAT=GML2, GML3 or GeoJSON. Thematic map feature types are supported only by the Web Mercator (SDMWM.wfs) service.
Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WFS
Input parameters:
[ VERSION=2.0.0 ] : OGC version number
{ REQUEST=GetFeature } : method name
{ TYPENAME=<layer name> } : feature type or layer name
[ CRSNAME=<EPSG projection code> ] : EPSG spatial reference system code for defining location.
{ <spatial filter> } : spatial filter(s) in the appropriate spatial reference system
[ OUTPUTFORMAT=GML2 | GML3 | GeoJSON ] : output format (default = GML2)
[ MAXFEATURES=<integer> ] : maximum number of features to be returned (limit: 250000)
DescribeLayer
This method exists to support user-defined styles by describing WMS named layers. If a named layer is not feature based, then the Layer Description is empty. However if the named layer is feature based, then the “WFS” attribute gives the URL prefix for the WFS containing the feature data.
Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS
Input parameters:
[ VERSION=1.3.0 ] : OGC version number
{ REQUEST=DescribeLayer } : method name
[ LAYERS=<layer name list> ] : feature type or layer name(s) (default = all applicable layers)
[ SLD_VERSION=1.1.0] : SLD version number
GetFeatureInfo
This method returns information about particular features shown on a map. It allows a client to request information about features on a map by adding to the map URL additional parameters specifying a location (as an X, Y offset from the upper left corner) and the number of nearby features about which to return information. A Layer is said to be “queryable” if the server supports the GetFeatureInfo operation on that Layer. A server may support GetFeatureInfo on some of its layers but not on all. The GetCapabilities request reports which layers, if any, are queryable.
Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS
Input parameters:
{ REQUEST=GetFeatureInfo } : method name
{ QUERY_LAYERS= } : This is the map layer(s) for which feature information should be retrieved. Its value is a comma-separated list of one or more map layers. This parameter must contain at least one layer name, but may contain fewer layers than the original GetMap request.
{ X=pixel_column } : X coordinate in pixels of feature (measured from upper left corner=0)
{ Y=pixel_row } : Y coordinate in pixels of feature (measured from upper left corner=0)
[ INFO_FORMAT=text/html | text/plain | gml2 ] : return format of feature information (MIME type) (default = text/plain)
[ FEATURE_COUNT= ] : This is the maximum number of features for which feature information should be returned. Its value must be a positive integer greater than zero (default = 1, limit: 250000).
{ <map_request_copy> } : partial copy of the request parameters that generated the map for which information is desired
GetMap
This method returns a rectangular map graphic for one or more supported feature types or layers, for a user specified area of interest. The layers returned by this method have map scale thresholds. Map unit features are not displayed unless map scale is in the range 1:0 to 1:250,000. Survey area features are not displayed unless map scale is in the range 1:100 to 1:5,000,000. Feature points and lines are not displayed unless map scale is in the range 1:0 to 1:250,000.
Web services for which this method is supported: https://sdmdataaccess.sc.egov.usda.gov/Spatial2/service.ows?SERVICE=WMS
Input parameters:
[ VERSION=1.3.0 ] : OGC version number
{ REQUEST=GetMap }: method name
{ LAYERS=<layer name list> }: feature type or layer name(s), comma-separated
[ SLD_BODY=<sld_body> ] : Styled Layer Descriptor, only valid for POST requests.
[ STYLES= <style list> ] : comma-separated list of one rendering style per requested layer
[ CRS=<EPSG projection code> ]: EPSG spatial reference system code for output map projection.
{ BBOX=<ounding box coordinates> } :bounding box corners (lower left, upper right) in the specfified (or defaulted) SRS
[ WIDTH=<integer> ] :map image width in pixels (default=640)
[ HEIGHT=<integer> ]: map image height in pixels (default=480)
[ FORMAT= image/png | image/jpeg | image/svg+xml ]: format of the output map image (default = image/svg+xml)
[ TRANSPARENT=TRUE | FALSE ]: background map image transparency (default = False)
[ BGCOLOR=<color_value> ]: hexadecimal red-green-blue color value for the background map image color (default = 0xFFFFFF)