Moxi Media Inc.
<GET-MAP> Tree View | Discussion Forum
IMF Developer's Guide » Map Configuration » <GET-MAP>  

The <GET-MAP> element defines the communication protocols used to get images from a WMS server.

Frequency Parent Elements (this element is valid within):
PRS1 <WMS-SERVICE>
   

Attributes Description
background-color The background color in the WMS request, as a comma separated string of red, green, blue values, example "255,0,0". Transformed to the BGCOLOR parameter when making the request. Optional, no BGCOLOR parameter is used if this attribute is not used.
exception-format The exception format that is returned from the WMS service in the event of errors. The format must match one of the exception formats supported by the server, so check the capabilities response for valid values. Formats that return XML are best, so use "WMS_XML" or "application/vnd.ogc.se_xml" if possible. Required.
format The format of the image returned from the WMS service. The format must match one of the formats supported by the server, so check the capabilities response for valid values. If possible, use a format that supports transparencies, which are "PNG", GIF", "image/png" or "image/gif". Required.
href The URL used for requesting map images. The map request arguments will be added to the value when making the requests, so only include the base URL as specified in the capabilities file. Note that if your URL contains ampersands, they must be escaped like "&amp;" in the XML. Required.
sld The sld attribute is used with Styled Layer Descriptor capable WMS services to specify alternate symbolization for layers. If you wish to use SLD symbolization, this attribute should contain the URL of the XML file that contains the styling. Optional.
transparent An indicator of whether the map should be requested with transparency where there is no data. Usually, WMS images are requested with TRANSPARENT=TRUE, but you can use this setting to ensure that the request will be done with TRANSPARENT=FALSE. Usually, it is best to not use this attribute and let IMF decide what to do. Optional.
   

Frequency Child Elements
OS+ <EXTRA-PARAMETER>
   

Frequency Description (in this context)
PRS1 The <GET-MAP> element must appear exactly once in the <WMS-SERVICE> element in the specified sequence.
OS+ The <EXTRA-PARAMETER> element may appear one or more times in the <GET-MAP> element.
   

Example:

<GET-MAP
 format="image/png"
 exception-format="application/vnd.ogc.se_blank"
 href="http://moximedia.com/cgi-bin/wms_gisi" /> 

Valid HTML 4.01!