Web Services

The NAMSS WMS is available to allow any WMS-enabled client to display the NAMSS surveys. It supports the Open Geospatial Consortium (OGC) WMS Implementation Specification, Version 1.1.1, the most widely used version of WMS.

Accessing the WMS

Enter the following URL into your WMS client:

https://walrus.wr.usgs.gov/namss/wms?request=GetCapabilities&service=WMS&version=1.1.1

For help accessing the WMS using a particular WMS client, use the links below:

• Adding a WMS to ArcGIS
• Adding a WMS to QGIS

Available Projections

Name	SRID	Authority
WGS 84 / Pseudo Mercator	3857	EPSG

Supported Operations

Operation	Description
GetCapabilities	Retrieves metadata about the service, including general information about the service itself and specific information about the available maps.
GetMap	Retrieves a map image for a specified area.
GetFeatureInfo	Retrieves information about features at a pixel location on a map.

Additional Operation Parameters

Operation(s)	Name	Default	Description
GetMap, GetFeatureInfo	FILTERS	None	Filter name and keyword pairs used to filter the results returned. The filter name and keywords are separated by a semicolon and each pair is separated by a comma. A list of available filters and examples are listed below.
GetFeatureInfo	BUFFER	1000	Width of search radius around selected point. The width is in meters.

Available Filters

Name	Description
identifier	This filter uses the name, aliases, activity name, and activity aliases of each survey to match the keywords.
data-type	This filter uses the data type of each survey to match the keywords.
year	This filter uses the start date and end date of each survey to match the keywords.
contributor	This filter uses the contributor and contributor aliases of each survey to match the keywords.

For all filters, use the "OR" operator to filter on multiple keywords.

Example:FILTERS=identifier;F-2-86-BS OR L87-056 OR G3D1106-001

For the year filter, use the ".." operator to filter by a range of years.

Example:FILTERS=year;1980..1990

Note:All filter matches are case-insensitive and result in a match if the keyword is contained in the filters lookup values. Each filter is AND'ed together with the other filters.

Filter Examples

The best way to understand the FILTERS parameter is to look at some examples. The examples will NOT have escaped characters to be more human readable.

An example request using the identifier filter and the "OR" operator to select two particular surveys:

            https://walrus.wr.usgs.gov/namss/wms?
            SERVICE=WMS
            &VERSION=1.1.1
            &REQUEST=GetMap
            &LAYERS=namss
            &STYLES=
            &BBOX=-11324910.110731713,2404403.1617385037,-9140645.590454517,4065226.9123188136
            &WIDTH=893
            &HEIGHT=679
            &FORMAT=image/png
            &TRANSPARENT=TRUE
            &BGCOLOR=0xffffff
            &FILTERS=identifier;B-32-91-TX OR B-08-88-GM
            &SRS=EPSG:3857
          

View Result

An example request using the data-type filter to select surveys with the data type 3D Multichannel Seismic using only 3D as the keyword:

            https://walrus.wr.usgs.gov/namss/wms?
            SERVICE=WMS
            &VERSION=1.1.1
            &REQUEST=GetMap
            &LAYERS=namss
            &STYLES=
            &BBOX=-11324910.110731713,2404403.1617385037,-9140645.590454517,4065226.9123188136
            &WIDTH=893
            &HEIGHT=679
            &FORMAT=image/png
            &TRANSPARENT=TRUE
            &BGCOLOR=0xffffff
            &FILTERS=data-type;3D
            &SRS=EPSG:3857
          

View Result

An example request using the year filter to select surveys from the years between 1980 and 1990:

            https://walrus.wr.usgs.gov/namss/wms?
            SERVICE=WMS
            &VERSION=1.1.1
            &REQUEST=GetMap
            &LAYERS=namss
            &STYLES=
            &BBOX=-11324910.110731713,2404403.1617385037,-9140645.590454517,4065226.9123188136
            &WIDTH=893
            &HEIGHT=679
            &FORMAT=image/png
            &TRANSPARENT=TRUE
            &BGCOLOR=0xffffff
            &FILTERS=year;1980..1990
            &SRS=EPSG:3857
          

View Result

An example request using the contributor filter to select surveys contributed by the Bureau of Ocean Energy Management using the alias boem:

            https://walrus.wr.usgs.gov/namss/wms?
            SERVICE=WMS
            &VERSION=1.1.1
            &REQUEST=GetMap
            &LAYERS=namss
            &STYLES=
            &BBOX=-11324910.110731713,2404403.1617385037,-9140645.590454517,4065226.9123188136
            &WIDTH=893
            &HEIGHT=679
            &FORMAT=image/png
            &TRANSPARENT=TRUE
            &BGCOLOR=0xffffff
            &FILTERS=contributor;boem
            &SRS=EPSG:3857
          

View Result

An example request using multiple filters:

            https://walrus.wr.usgs.gov/namss/wms?
            SERVICE=WMS
            &VERSION=1.1.1
            &REQUEST=GetMap
            &LAYERS=namss
            &STYLES=
            &BBOX=-11324910.110731713,2404403.1617385037,-9140645.590454517,4065226.9123188136
            &WIDTH=893
            &HEIGHT=679
            &FORMAT=image/png
            &TRANSPARENT=TRUE
            &BGCOLOR=0xffffff
            &FILTERS=data-type;3D,year;1985..1988,contributor;boem
            &SRS=EPSG:3857
          

View Result