Inputs and Behaviors

When invoking GetMap a WMS query can specify:


Input	Required	Description
`VERSION=version`	Yes	Request version. Spectrum Technology Platform WMS supports both version 1.1.1 and 1.3.0 of the OGC specification.
`SERVICE=WMS`	Yes	Service type. This is always WMS.
`REQUEST=GetMap`	Yes	Request name. For a GetMap request this is always GetMap.
`LAYERS=layer_list`	Yes	The layer or layers to be included in the map image. Each layer should be separated by a comma. For example: `LAYERS=Layer1,Layer2,Layer3`
`STYLES=style_list`	Yes	Comma-separated list of one rendering style per requested layer. A style is required for each layer requested. If no style is requested, the attribute must be present but without a value. If requesting multiple layers, the styles listed should be in the same order as the layers. For example: `STYLES=Style1,,Style3` In the above example the second style (for the second layer requested) is left blank, allowing the default style defined for the layer to be used.
`SRS=namespace:identifier`	Yes for 1.1.1	The spatial reference system used in the map (numeric representation of the projection of the map, also known as the coordinate reference system). This parameter is only used for 1.1.1 versions of the OGC specification.
`CRS=namespace:identifier`	Yes for 1.3.0	The coordinate reference system used in the map (numeric representation of the projection of the map, also known as the spatial reference system). This parameter is only used for 1.3.0 versions of the OGC specification.
`BBOX=minx,miny,maxx,maxy`	Yes	The area to be mapped. The bounding box is specified as the four coordinates of the corners of the box that bounds the map area to be included in the image. The BBOX coordinates are always expressed in the units of the SRS or CRS. The axis order (which axis is x and which axis is y) is determined by the authority that owns the coordinate system definition. This is most frequently EPSG, whose definitions are available at www.epsg-registry.org. For the GetMap operation, you need to be aware of the axis order for each coordinate system when you construct the BBOX.
`WIDTH=output_width`	Yes	Width in pixels of map image.
`HEIGHT=output_height`	Yes	Height in pixels of map image.
`FORMAT=output_format`	Yes	The format in which the map image is to be returned.
`TRANSPARENT=TRUE\|FALSE`	No	The transparency and color of the background of the image. If nothing is specified, the value is FALSE.
`BGCOLOR=color_value`	No	Hexadecimal red-green-blue color value for the background color (default=0xFFFFFF).
`RESOLUTION=resolution`	No	The DPI of the map image. If less than 72 dpi, an exception is thrown.
`EXCEPTIONS=exception_format`	No	The format in which exceptions are to be reported by the WMS (default=XML).

The request parameters are always sent as an HTTP query string. The following are sample GetMap requests:

WMS version 1.1.1:

http://<server>:<port>/rest/Spatial/WMS?VERSION=1.1.1&SERVICE=WMS&REQUEST=GetMap
&SRS=EPSG:4326&BBOX=-100,0,90,100&WIDTH=400&HEIGHT=300&Layers=World&STYLES=AreaStyle
&FORMAT=image/png

WMS version 1.3:

http://<server>:<port>/rest/Spatial/WMS?VERSION=1.3.0&SERVICE=WMS&REQUEST=GetMap
&CRS=EPSG:4326&BBOX=-100,0,90,100&WIDTH=400&HEIGHT=300&Layers=World&STYLES=AreaStyle
&FORMAT=image/png

Note: The code above should all be on a single line with no breaks. Due to space limitations, we cannot display the request in such a way in this document.