This element is used to configure the background maps to be displayed. The more advanced options are described below. Rather straightforward options like northArrowVisible are self explaining.
Contents:
| Table of Contents | ||
|---|---|---|
|
description
Optional description of the configuration. Used for reference purposes only.
Zoom Extents
The extents defined will appear in a drop down list in the toolbar above the map. Selecting an extent will change the view window of the map to the specified location.
...
- name: name of the zoom extent (displayed in the drop-down list)
left, right, top, bottom: Coordinates of the zoom extent. Note that in displaying the maps for the extent defined, the map display will be scaled to fit the extent in the current display window.
geoDatum
Coordinate system the extents are defined in. Enumeration of available coordinate systems is available in Appendix B.
defaultExtent
Definition of the default zoom extent.
extraExtent
Definition of the additional zoom extents. Multiple entries may exist.
Example
An example configuration containing two extents is shown below.
| Code Block | ||
|---|---|---|
| ||
<geoDatum>WGS 1984</geoDatum> <defaultExtent id="my_defaultZoom" name="Default"> <left>96.38403320312536</left> <right>112.68774414062536</right> <top>1.8519463253148256</top> <bottom>-5.9482950514716</bottom> </defaultExtent> <extraExtent id="Indonesia" name="Indonesia"> <left>92</left> <right>141</right> <top>7</top> <bottom>-11</bottom> </extraExtent> |
Connections
For downloading layers from servers, sever different types of connections can be established.
wfsConnection
Notice that you need to specify a mapLayersCacheDir in the global.properties, like mapLayersCacheDir=%REGION_HOME%/MapCache
More info on connection to ArcSDE and WFS can be found here.
wmsConnection
Defines a Web Map Service (WMS) connection that can be referenced by a wmsLayer.
arcSdeConnection
Notice that you need to specify a mapLayersCacheDir in the global.properties, like mapLayersCacheDir=%REGION_HOME%/MapCache
More info on connection to ArcSDE and WFS can be found here.
Layer Choices
Many different types of layers can be defined to be included in the map. All configured layers will be shown in the layer selection panel, where they can be turned on/off by the user. Some of these layers will be explained below.
coverageTileArchiveLayer
Since 2013.01 FEWS enables using a compressed grid file for your DEM. The compression is done per scale and in tiles and archived in a zip file, pretty similar as openStreetMap works.
You can prepare a CTA (coverage tile archive) with the F12 menu in the explorer (F12 -> convert -> convert ascii grid to coverage tile archive).
As the resulting file should be in meters (see below why) you may need to specify a conversion factor from eg. centimeter to meter. You can also define an accuracy of the compressed values. Normally centimeter accuracy is more than enough, sometimes you can easily go to decimeters, which compresses much better of course. For synchronization reasons you may want to split the resulting file in parts of e.g. max 2 GB. Usually this is more than enough. The resulting compression is generally a factor of about 10-20. But the main reason is the much better performance of the GUI as per pixel is already determined which value should be plotted.
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<gridPlot id="Petten">
<timeSeriesSet>
<moduleInstanceId>Floodmap</moduleInstanceId>
<valueType>grid</valueType>
<parameterId>H.sim.hist</parameterId>
<locationId>Floodmap_grid</locationId>
<timeSeriesType>simulated historical</timeSeriesType>
<timeStep unit="minute" multiplier="1"/>
<readWriteMode>read only</readWriteMode>
</timeSeriesSet>
<classBreaks>
<break lowerValue="0" color="light blue" opaquenessPercentage="25"/>
<break lowerValue="1" color="blue" opaquenessPercentage="75"/>
<break lowerValue="2" color="purple" opaquenessPercentage="75"/>
</classBreaks>
<geoMap>
<geoDatum>Rijks Driehoekstelsel</geoDatum>
<projection>mercator</projection>
<defaultExtent id="Petten testmodel">
<left>-1000</left>
<right>10000</right>
<top>4000</top>
<bottom>0</bottom>
</defaultExtent>
<extraExtent id="Nederland">
<left>-200000</left>
<right>500000</right>
<top>750000</top>
<bottom>200000</bottom>
</extraExtent>
<scaleBarVisible>true</scaleBarVisible>
<northArrowVisible>true</northArrowVisible>
<labelsVisible>true</labelsVisible>
<backgroundColor>light blue1</backgroundColor>
<openStreetMapLayer id="osm" name="Open Street Map">
<url>http://tile.openstreetmap.org</url>
<cacheDir>$MAP_CACHE$/openstreetmaps</cacheDir>
</openStreetMapLayer>
<coverageTileArchiveLayer id="asc">
<file>petten.cta</file>
<visible>false</visible>
<useAsLocalDatumReference>true</useAsLocalDatumReference>
<classBreaks>
<lowerColor>brown</lowerColor>
<upperColor>green</upperColor>
<lowerValue>-4</lowerValue>
<lowerValue>-1</lowerValue>
</classBreaks>
</coverageTileArchiveLayer>
</geoMap>
</gridPlot>
|
esriShapeLayer
With this layer a background shape file can be defined. This layer supports the common shape layer elements.
...
For testing purposes you can use "http://tile.openstreetmap.org"
wmsLayer
To make use of a WMS server you have to use the option for wmsLayer.
...
| Code Block | ||
|---|---|---|
| ||
<wmsLayer id="ahn2"> <url>http://geodata.nationaalgeoregister.nl/ahn2/wms?service=wms&request=getcapabilities</url> <wmsLayerName>ahn2_5m</wmsLayerName> <cacheDir>$REGION_HOME$/ahn2_5m</cacheDir> </wmsLayer> |
serverShapeLayer
To make use of a Wfs or ArcSDE connection you have to use the option for serverShapeLayer. This layer supports the common shape layer elements.
layer
Definition of a GIS layer to be displayed.
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
<layer id="World" name="ArcGIS World_Topo_Map">
<className>nl.wldelft.libx.openmap.GenericTileServerLayer</className>
<properties>
<string key="tileUrlPattern" value="http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/%ZOOM%/%ROW%/%COLUMN%"/>
<string key="cacheDir" value="%REGION_HOME%/mapcache/Esri_topo"/>
<int key="minZoomLevel" value="1"/>
<int key="maxZoomLevel" value="19"/>
<int key="topZoomLevel" value="21"/>
<int key="tileSize" value="256"/>
</properties>
</layer>
<layer id="Canvas" name="ArcGIS Canvas World_Light_Gray_Base">
<className>nl.wldelft.libx.openmap.GenericTileServerLayer</className>
<properties>
<string key="tileUrlPattern" value="http://server.arcgisonline.com/arcgis/rest/services/Canvas/World_Light_Gray_Base/MapServer/tile/%ZOOM%/%ROW%/%COLUMN%"/>
<string key="cacheDir" value="%REGION_HOME%/mapcache/Esri_Canvas_World_Light_Gray_Base"/>
<int key="minZoomLevel" value="1"/>
<int key="maxZoomLevel" value="19"/>
<int key="topZoomLevel" value="21"/>
<int key="tileSize" value="256"/>
</properties>
</layer>
<openStreetMapLayer id="Osm" name="Open Street Map">
<url>http://tile.openstreetmap.org</url>
<cacheDir>$REGION_HOME$/OsmTiles</cacheDir>
</openStreetMapLayer>
<openStreetMapLayer id="Osm" name="Open Street Map (Toner)">
<url>http://tile.stamen.com/toner</url>
<cacheDir>$REGION_HOME$/mapcache/stamen_toner</cacheDir>
</openStreetMapLayer> |
Common Shape Layer Elements
These elements are supported for both the serverShapeLayer and the esriShapeLayer:
...