Raster Data Sources
Raster data sources are used to access raster spatial data (images). See the following sections for information on the various types of raster data sources that are supported.
| ECW - JPG2000 | OpenStreetMap |
| GDAL - Geospatial Data Abstraction Library | WMS Server |
| ArcGIS REST | WMTS Server |
| JMap Server |
ECW - JPG2000
With this type of data source, it is possible to read ECW or JPG2000 image files or to connect to an ECWP server (ERDAS Image Web Server) to obtain images. It is not possible to configure both at the same time.
| Parameters | |
|---|---|
| Selected files | Select one or more ECW or JPG2000 image files to read. If many files are selected, they will be considered as a mosaic. The files must be georeferenced. |
Note: This type of data can also be read by the GDAL data source with the same performance. This data source is kept for compatibility with existing configurations.
GDAL - Geospatial Data Abstraction Library
This type of spatial data source allows you to read a wide variety of raster data formats. GDAL (Geospatial Data Abstraction Library) is an open source library specializing in raster data conversion and processing.
There can be one or more source image files (mosaic of images). The images of the mosaic can overlap and there can be holes in the mosaic.
When the data source is updated, if the option is activated, a pyramid of lower resolution images is created by JMap Server and stored in the image cache. The image cache is then used for high performance production of images on the fly at specific resolutions. Depending on the initial image sizes and parameters, the image cache size can become voluminous. Typically, the total image cache is about the same size as the original images. Available disk space must be sufficient before updating this data source. It is possible that the data format selected will not require the creation of a pyramid. In this case, the parameter will be ignored.
| Parameters | |
|---|---|
| Selected files | Select one or more image files to read. You have to select only the files containing the raster data (.tif, .jpg, etc.) and not the additional files (.xml, .prj, etc.). If many files are selected, they will be considered as a mosaic. The files must be georeferenced. |
| Cache path | The directory where JMap Server will store generated image files for the various resolutions. Default is JMAP_HOME/cache/raster. |
| Image interpolation | Method for producing images with reduced resolutions from images with higher resolutions. Default is Cubic and this method usually produces the best results. |
| Compute statistics (may take some time) | Statistics on image pixels simplify the analysis of these images. JMap extensions such as JMap Imagery use these statistics to work. Calculating statistics can take several minutes and this option should only be activated when necessary. If you do not need statistics, do not enable this option. |
| Create a pyramid | Activates the creation of an image pyramid with several resolutions. This greatly improves performance for producing images on the fly. |
| Pyramid image interpolation | Method used to produce pyramid images. The default value is Cubic and this method usually produces the best results. |
ArcGIS REST
JMap Server can connect to ArcGIS Server and ArcGIS Online REST services to access WMTS-type raster data published by this type of service.
| Parameters | |
|---|---|
| URL | URL of the service of an ArcGIS REST layer.e.g. http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5 |
| Username | Enter the username to authenticate and log in to the ArcGIS REST service. |
| Password | Enter the password to authenticate and log in to the ArcGIS REST service. |
JMap Server
JMap Server can use a raster spatial data source that comes from another JMap Server instance. To enable this, you must start by configuring a connection towards the other JMap Server. Refer to JMap Server to JMap Server Connections for more information.
| Parameters | |
|---|---|
| Remote connection | Select the connection towards another JMap Server instance that must be used to extract spatial data and attributes. The connection must already be configured in JMap Admin. |
| Data source | Select the existing raster spatial data source on the other JMap Server instance you wish to access. The data source must be shared by the other server. |
OpenStreetMap
JMap Server can use the OpenStreetMap map as a raster data source. No parameters need to be configured for this type of data source.
WMS server
Web Map Service (WMS) is a standard proposed by the Open Geospatial Consortium that defines how client applications must request maps from a WMS compatible server. The protocol used is HTTP and the maps returned are typically images in popular formats (PNG, GIF, JPEG, etc.). WMS servers publish their capabilities in an XML document that specifies the types of requests supported as well as the metadata (list of layers, supported projections, etc.).
By configuring WMS data sources, you allow JMap to connect to and query WMS compatible servers (versions 1.0 to 1.3). You can then create raster layers based on these WMS data sources inside projects.
| Parameters | |
|---|---|
| Get server capabilities (GetCapabilities) | Enter the GetCapabilities URL that will return the WMS server’s capabilities. The URL should look like this: http://www.server.com/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities |
| Enable HTTP authentication | Enable this option if the WMS server controls access to the WMS service via HTTP authentication. In this case, enter the username and password that must be used. |
Once you have obtained the capabilities, you can define the parameters for the other types of requests in the WMS protocol. JMap Admin automatically suggests default queries that usually work very well. They are generated from the GetCapabilities request. If you wish to modify these default requests, you must select the Override default request option and enter new requests. For each type of request, you can also activate HTTP authentication and provide sign-on parameters.
| Parameters | |
|---|---|
| Get map(GetMap) | This request is used to get a WMS server map. |
| Get feature info(GetFeatureInfo) | This request is used to get the attributes of a map element. |
WMTS Server
Web Map Tile Service (WMTS) is a standard offered by the Open Geospatial Consortium that determines how client applications perform queries to obtain map data in the form of predefined tiles from a data server.
By configuring WMTS data sources, you enable JMap to connect to and query WMTS-compatible servers (version 1.0.0). You can then create raster layers based on WMTS data sources within projects.
| Parameters | |
|---|---|
| URL | Enter the GetCapabilities URL that will return the capabilities of the WMTS server. The URL should be similar to this one: http://www.server.com/wmts?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetCapabilities Examples: https://basemap.nationalmap.gov/arcgis/rest/services/USGSHydroCached/MapServer/WMTS/1.0.0/WMTSCapabilities.xml and http://cite.deegree.org/deegree-webservices-3.4-RC3/services/wmts100?service=WMTS&request=GetCapabilities Press Next to continue configuring the data source. |
| Original projection | Select the projection of the map data. |
| Start update automatically | Check this box to automatically update this data source. |