WPS download community module¶
WPS download module provides some useful features for easily downloading: * Raster or Vector layer as zip files * Large maps as images * Time based animation The module also provides facilities to control the output file size.
Installing the WPS download module¶
Download the WPS download module from the nightly GeoServer community module builds.
Make sure to match the version of the extension to the version of the GeoServer instance.
Extract the contents of the archive into the
WEB-INF/libdirectory of the GeoServer installation.
This module provides the following WPS process:
gs:Download: can be used for downloading Raster and Vector Layers
gs:DownloadEstimator: can be used for checking if the downloaded file does not exceeds the configured limits.
gs:DownloadMap: allows to download a large map with the same composition found on the client side (eventually along with an asynchronous call)
gs:DownloadAnimation: allows to download a map with the same composition found on the client side, with animation over a give set of times
Configuring the limits¶
The first step to reach for using this module is to create a new file called download.properties and save it in the GeoServer data directory. If the file is not present GeoServer will automatically create a new one with the default properties:
# Max #of features maxFeatures=100000 #8000 px X 8000 px rasterSizeLimits=64000000 #8000 px X 8000 px X 3 bands X 1 byte per band = 192MB writeLimits=192000000 # 50 MB hardOutputLimit=52428800 # STORE =0, BEST =8 compressionLevel=4
Where the available limits are:
maxFeatures: maximum number of features to download
rasterSizeLimits: maximum pixel size of the Raster to read
writeLimits: maximum raw raster size in bytes (a limit of how much space can a raster take in memory). For a given raster, its raw size in bytes is calculated by multiplying pixel number (raster_width x raster_height) with the accumated sum of each band’s pixel sample_type size in bytes, for all bands
hardOutputLimit: maximum file size to download
compressionLevel: compression level for the output zip file
Note that limits can be changed when GeoServer is running. Periodically the server will reload the properties file.