ERDDAP Easier access to scientific data
|
ERDDAP Easier access to scientific data
|
Brought to you by NOAA NMFS SFSC ERD |
In practice, we haven't found any WMS clients that properly handle dimensions
other than longitude and latitude (e.g., time), a feature which is specified by the WMS
specification and which is utilized by most datasets in ERDDAP's WMS servers.
You may find that using a dataset's Make A Graph form and selecting the .kml file type
(an OGC standard) to load images into Google Earth provides
a good (non-WMS) map client.
See the list of datasets with Make A Graph at this ERDDAP installation.
In practice, it is probably easier and more versatile to use a dataset's
Make A Graph form
than to use WMS for this purpose.
See the list of datasets with Make A Graph at this ERDDAP installation.
| Request parameter | Mandatory/ Optional |
Description |
|---|---|---|
| VERSION=version | M | Request version.
Currently, ERDDAP's WMS supports "1.1.0", "1.1.1", and "1.3.0". |
| REQUEST=GetMap | M | Request name. |
| LAYERS=layer_list | M | Comma-separated list of one or more map layers.
Layers are drawn in the order they occur in the list. Currently in ERDDAP's WMS, the layer names from datasets are named datasetID:variableName . In ERDDAP's WMS, there are three layers not based on ERDDAP datasets: * "Land" may be drawn BEFORE (as an under layer) or AFTER (as a land mask) layers from grid datasets. * "Coastlines" should usually be drawn AFTER layers from grid datasets. * "Nations" draws political boundaries. This should usually be drawn AFTER layers from grid datasets. |
| STYLES=style_list | M | Comma-separated list of one rendering style per requested layer.
Currently in ERDDAP's WMS, the only style offered for each layer is the default style, which is specified via "". For example, if you request 3 layers, you can use "STYLES=,,". Or, even easier, you can request the default style for all layers via "STYLES=". |
| 1.1.0: SRS=namespace:identifier 1.1.1: SRS=namespace:identifier 1.3.0: CRS=namespace:identifier |
M | Coordinate reference system.
Currently in ERDDAP's WMS 1.1.0, the only valid SRS is EPSG:4326. Currently in ERDDAP's WMS 1.1.1, the only valid SRS is EPSG:4326. Currently in ERDDAP's WMS 1.3.0, the only valid CRS's are CRS:84 and EPSG:4326, All of those options support longitude from -180 to 180 and latitude -90 to 90. Currently in ERDDAP's WMS, datasets with longitude values 0 to 360 are only available from longitude 0 to 180 in WMS. |
| BBOX=minx,miny,maxx,maxy | M | Bounding box corners (lower left, upper right) in CRS units. |
| WIDTH=output_width | M | Width in pixels of map picture. |
| HEIGHT=output_height | M | Height in pixels of map picture. |
| FORMAT=output_format | M | Output format of map.
Currently in ERDDAP's WMS, only image/png is valid. |
| TRANSPARENT=TRUE|FALSE | O | Background transparency of map (default=FALSE).
If TRUE, any part of the image using the BGColor will be made transparent. |
| BGCOLOR=color_value | O | Hexadecimal 0xRRGGBB color value for the background color (default=0xFFFFFF, white).
If Transparent=TRUE, we recommend BGCOLOR=0x808080, since white is in some color palettes. |
| EXCEPTIONS=exception_format | O | The format in which exceptions are to be reported by the WMS (the default is the xml option).
Currently, ERDDAP's WMS 1.1.0 and 1.1.1 supports "application/vnd.ogc.se_xml", "application/vnd.ogc.se_blank" (a blank image) and "application/vnd.ogc.se_inimage" (the error in an image). Currently, ERDDAP's WMS 1.3.0 supports "XML", "BLANK" (a blank image), and "INIMAGE" (the error in an image). |
| TIME=time | O | Time value of layer desired, specified in ISO8601 format: yyyy-MM-ddTHH:mm:ssZ .
Currently in ERDDAP's WMS, you can only specify one time value per request. In ERDDAP's WMS, the value nearest to the value you specify (if between min and max) will be used. In ERDDAP's WMS, the default value is the last value in the dataset's 1D time array. In ERDDAP's WMS, "current" is not supported. To get the last value (whether it is recent or not), just don't specify a value (use the default). |
| ELEVATION=elevation | O | Elevation of layer desired.
Currently in ERDDAP's WMS, you can only specify one elevation value per request. In ERDDAP's WMS, this is used for the altitude dimension (if any). (in meters, positive=up) In ERDDAP's WMS, the value nearest to the value you specify (if between min and max) will be used. Currently in ERDDAP's WMS, the default value is the last value in the dataset's 1D altitude array. |
| dim_name=value | O | Value of other dimensions as appropriate.
Currently in ERDDAP's WMS, you can only specify one value per dimension per request. In ERDDAP's WMS, this is used for the non-time, non-altitude dimensions. The name of a dimension will be "dim_" plus the dataset's name for the dimension, for example "dim_model". In ERDDAP's WMS, the value nearest to the value you specify (if between min and max) will be used. Currently in ERDDAP's WMS, the default value is the last value in the dimension's 1D array. |
(Revised from Table 8 of the WMS 1.3.0 specification)
ERDDAP is compatible with the current WMS 1.3.0 standard.
ERDDAP is also compatible with the older WMS 1.1.1 standard, which may be needed when working with older client software.
ERDDAP is also compatible with the older WMS 1.1.0 standard, which may be needed when working with older client software.