Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Name

Type

Required

Default

Description

id

string

yes


Unique identifier for this map engine

spatialengine

string

urn:com.cohga.server.spatial.geotools#1.0yes


The spatial engine that will be providing the data

format

string

yes


What image format the map engine will support

layers

#layer

yes


A list of the layers that this map engine will provide

styles

#style

yes


A list of the styles that can be used to display a layer.

Alternatively this can point to an external SLD file

legend

#legend

no

Alter the legend display

timeout

integer

no

10

Number of second before drawing of map will stop

antialiasing

boolean

no

true

Should the rendering use antialiasing

limit

integer

no

Limit the number of features that are drawn on the map to help reduce the time to render the image

maxerrorcount

integer

no

10

Maximum number of rendering errors that can occur before the rendering is aborted

layer

Properties

Name

Type

Cardinality

Description

id

string

1..1

The unique id of the layer

label

string

1..1

The user visible label for the label

layer

string

1..1

The layer, within the spatial engine, that this layer will use

style

#style

1..1

The style that this layer should be displayed with

minscale

number

0..1

The minimum scale the layer should be rendered at

maxscale

number

0..1

The maximum scale the layer should be rendered at

style

Properties

Name

Type

Cardinality

Description

id

string

1..1

The unique id for this style, which can then be referenced by a layer

type

string

0..1

What geometry type does this style represent? point, line or polygon.

This is only used if the style is defined inline and not required if this style references an SLD file

...

See the section below on inline styles for information on how the styles are defined.

...

legend

Alter the display of the legend

Properties

None

Sub-tags

Name

Type

Cardinality

Description

remove

#remove

0..1

Layers to remove.

Layers listed here will not display.

layer

#layer

0..n

Layer to include.

Only layers listed here will display

Content

None

remove

Properties

None

Sub-tags

Name

Type

Cardinality

layer

#layer

0..n

Content

None

layer

Properties

None

Content

The name of the layer, or a comma separated list of layer names. Also support * for wildcards.

Sub-tags

None

Examples

Example Weave map engine
Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?>

<config xmlns="urn:com.cohga.server.config#1.0" xmlns:weave="urn:com.cohga.server.map.weave#1.0">

	<weave:mapengine id="vector">
		<spatialengine>gis</spatialengine>
		<format>image/png32</format>
		<layers>
			<layer id="contours01" label="Contours 1m" layer="GIS.CONTOURS_01M" style="contour"/>
			<layer id="contours02" label="Contours 2m" layer="GIS.CONTOURS_02M" style="contour"/>
			<layer id="contours05" label="Contours 5m" layer="GIS.CONTOURS_05M" style="contour"/>
			<layer id="contours10" label="Contours 10m" layer="GIS.CONTOURS_10M" style="contour"/>
		</layers>
		<styles>
			<style id="contour">
				<type>line</type>
				<stroke-color>#853111</stroke-color>
				<stroke-width>2</stroke-width>
			</style>
		</styles>
		<legend>
			<!-- remove some of the layers from the legend -->
			<remove>
				<layer>contours01</layer>
				<layer>contours02</layer>
				<layer>contours05</layer>
			</remove>
			<!-- an alternatove to the above remove tag here would be this, since it lists the only layers that should be in the legend
			<layer>contours10</layer>
			-->
		</legend>
	</weave:mapengine>

</config>

...

Using an external SLD file to style a layer
Code Block
languagexml
			<layer id="contours01" label="Contours 1m" layer="GIS.CONTOURS_01M" style="sld\contours.sld"/>

...

Alternatively, when referring to an external SLD file it can also be specified in the style itself, rather than the layer, so the layer can reference one of the inline styles, and the style then points to the external SLD file, e.g.

Code Block
languagexml
		<styles>
			<style id="contour">sld\contours.sld</style>
		</styles>

This way if you use the same SLD file for multiple layers you can just reference a single inline style and have that style refer to the SLD file.

...