Adding custom map layers

You can add custom layers to geographical maps. For example, you can add geographical information that is made available by a public server.

1. Back up and edit the following file: $JazzSM_HOME/profile/installedApps/JazzSMNode01Cell/isc.ear/ncp_gis.war/resources/config.json
2. Create a new customLayers section or uncomment one of the default sections, and specify the correct parameters.
   The WMS parameters that are accepted by OpenLayers are listed at http://openlayers.org/en/latest/apidoc/ol.source.TileWMS.html. The parameters that you must use are defined in the WMS request specification of your WMS server. Use the following syntax for parameters: "PARAM_NAME":"PARAM_VALUE". To avoid errors, use a validation tool to validate the JSON.

   The ArcGISRest parameters that are accepted by OpenLayers are listed at https://openlayers.org/en/latest/apidoc/module-ol_source_TileArcGISRest-TileArcGISRest.html.

   The WMTS parameters that are accepted by OpenLayers are listed at https://openlayers.org/en/latest/apidoc/module-ol_source_WMTS.html.

   The following example configures parameters for one WMS custom layer, one ArcGISRest custom layer, and one WMTS custom layer.

   "customLayers": [
      {
          "layerName": "Drainage Divisions",
          "layerType": "wms",
          "url": "http://geoserver.nationalmap.nicta.com.au/admin_bnds_abs/ows",
          "params": {
             "LAYERS": "admin_bnds:ADD_2011_AUST"
          }
   	"selected":"true"
      }, {
          "layerName": "Prohibited Areas",
          "layerType": "arcGISRest",
          "url": "http://services.ga.gov.au/gis/rest/services/NM_Reserves/MapServer",
          "params": {}
   
   	"selected":"false"
       }
          {
          "layerName": "New Zealand Earthquakes",
          "layerType": "wmts",
          "capabilities": {
                "url": "https://openlayers.org/en/v4.3.4/examples/data/WMTSCapabilities.xml",
                "layer": "layer-7328",
                "matrixSet": "EPSG:3857"
                }
   	"selected":"false"
          }
   ]

   If you do not supply any arcGISRest parameters, include the line but leave it empty: "params": {}. Removing or omitting sections from the file causes errors.

   The layerName parameter can be set to any unique descriptive value.

   For custom map layers, the layerType value must be one of the following supported values:

   • arcGISRest
   • wms
   • wmts

   Custom layers that have the selected parameter set to true are displayed by default in the geographical views. The user can show or hide any custom layers.

3. Define multiple layers if you want. The z-index of the layers is defined by their position in the file. To display one custom layer above another layer, define it higher in the file. The topology layer is displayed on top of the other layers, and the base layer is displayed underneath the other layers.