This update exposes Weave map engines as a WMS service. The bundle can also be used to create URL's that can be called from external applications to create custom map images. The bundle supports additional parameters beyond those required by WMS and allows for more customised map output.
...
Name | Description | WMS Compliant |
|---|---|---|
srs | Coordinate reference system of the coordinates specified in the URL | XY |
width | Width of generated image in pixels | XY |
height | Height of generated image in pixels | XY |
format | Output format of the generated image | XY |
bgcolor | Background colour | XY |
transparent | true if transparent images should be created, false if opaque images should be generated | XY |
bbox | Comma separated minx, miny, maxx and maxy of the generated image | XY |
layers | List of layers to draw, all layers will be drawn if not set at all, and no layers drawn if layers is set to no value | XY |
exceptions | Method used to return errors to the caller | XY |
size | Comma separated width and height of generated image in pixels | |
dpi | DPI of generated image, to ensure scale dependencies are calculated correctly | |
minx | Left X coordinate | |
miny | Bottom Y coordinate | |
maxx | Right X Coordinate | |
maxy | Top Y coordinate | |
x | Centre Center X coordinate | |
y | Centre Center Y coordinate | |
centrecenter | Comma separated X and Y coordinate. Both | |
scale | Scale to generate map at | |
entity | Entity to use to determine map extent and draw highlight | |
ids | Identifiers of entities to zoom to and highlight | |
filter | Filters to be applied to 'ids' before calculating the extent. For use if external system uses different id's for the underlying GIS data | |
buffer | Amount to scale entity extent by to calculate extent, e.g. 1.2 to place a 20% buffer around the entity bounds | |
minscale | Minimum scale to zoom to when zooming to an entity | |
highlight | false if the entity highlight should not be drawn, true if it should be drawn | |
hlcolor | Vector highlight colour | |
| mcolor | Marker highlight colour. Should be blue, brown, dark, green, orange, purple, red, silver or yellow. The default is green. The mcolor 'dark' is a dark grey. |
| Note |
|---|
When specifying the map bounding box setting minx, miny, maxx and maxy is the same as specifying just bbox, and bbox will take precedence if both are persentpresent. All of the above values, except srs, can be set in the context and overwritten in the URL, but if setting you're the map extent using an entity then the entity and ids parameters must both be included in the URL, the entity value in the context only applies to the highlighting. |
The above settings will generally be supplied by the WMS client, and defaults can be set in the context.
Generally these will all be set by the WMS client when sending WMS requests to the Weave server and do not need to be specified in the configuration, however, you may want to set these values in the configuration if you're intending on constructing and using the URL's from another application and you want to simplify the URL that the other application needs to use.
For example, if you have an application that you want to always generate an 800x800 PNG image with a light blue background then you could use the URL:/weave/wms/test?width=800&height=800&bgcolor=0x7f7fff&format=png&bbox=140,-36,141,-35
or you could set width, height, format and bgcolor in the context and use the following URL instead/weave/wms/test?bbox=140,-36,141,-35
This allows you to provide a simplified URL to the application provider while specifying the fixed settings yourself, it all depends upon the requirements of the other application and how much of it can be pre-set.
...
| Code Block | ||
|---|---|---|
| ||
/weave/wms/test?entity=property&ids=242765
|
| Code Block | ||
|---|---|---|
| ||
/weave/wms/test?entity=roads&ids=AS14124&minscale=5000 |
...