Adding WMS Maps

To add WMS maps to a map configuration:

  1. Open the Map Configs tab.
  2. In the Map Configuration drop-down list, select the map configuration to which you want to add a map.
  3. In the Map Configs tab, open the Maps subtab.
  4. In the Maps subtab, click the Add WMS Maps button.
    The Add WMS Maps dialog box opens.
  5. In the Add\Edit WMS Maps dialog box, enter the URL in the WMS URL text box.
    If you are adding a HTTPs WMS URL which uses a SSL certificate that is not trusted by SSA server, you need to install the root certificate or any intermediate certificates for corresponding certificate authority in SSA trust store. For more information on how to install SSL certificate for web map service, refer to ../appendix/appendixJ.html#appendixh.
    Note: The WMS URL may or may not require authentication.
  6. Select the authentication from Authentication Type drop-down list. It has following options:
    Option Description
    No Authentication The WMS is not secured and does not require a login.
    Basic Authentication The WMS is secured and a user name and password are required to login and access the WMS.
    Query Parameters Inline The WMS is not secured, but a username and password are required as part of the WMS URL parameters. Enter query parameter names and values as below:
    • Username Query parameter
    Enter the parameter name for the username. For example - login, userid, login id etc.
    • Username
    Enter the username
    • Password Query Parameter
    Enter parameter name for the password. For example - password
    • Password
    Enter the password
  7. Click the Open button to read the WMS capabilities. The dialog will move to step 2 and display the available layers. Click Cancel to close Add\Edit WMS Maps dialog box.
  8. In the Add\Edit WMS Maps dialog box, the WMS URL is displayed under Viewing WMS.
  9. Enter the friendly name for this map in Enter name for this WMS Map text box. This name appears under Maps list in Maps page.
    Note: You cannot keep this text box empty and the WMS's friendly map name cannot be same as a map name already present in map configuration.
  10. Select layers from the Available Layers list.
    Note: You may select more than one layer by pressing Ctrl button.
  11. Click the Add button to move selected layers to Selected Layers box.
  12. Click the Remove button to remove one or more layers from Selected Layers box.
  13. Select a layer in the Selected Layers list and click the Up and Down arrow buttons to re-order its position in the list.
  14. Select style from Choose Style drop-down list for each layer.
  15. Select from available check box options:
    Option Description
    Add as a Base Map Select to add the WMS as a base map.
    Get feature info Select to get feature information.
    Note: The Get Feature Info check box is disabled and unchecked if the does not support the getFeatureInfo capability.
    Get Legend Graphic Select to get legend graphics.
    CORS Enabled Select to check if the tile server supports CORS (Cross-origin Resource Sharing).
    Note: When user will add WMS map either secured or non –secured, SSA will check whether these supports CORS or not and“CORS Enabled” option will be checked/unchecked by default.”
    Note: The Get feature info check box and Get Legend Graphic check box are valid only for WMS’s added as business maps and will be enabled only if Add as a Base Map check box is unchecked.
  16. Choose projections from the Choose Projection drop-down list.
    Note: The projections of any Tile Maps, WMS base maps and WMS overlay maps added to the map configuration must be the same otherwise the maps will not align correctly. If the projection chosen is different to the existing one in the map configuration you will get a warning message as below when you eventually try to add the WMS.
    • When a WMS base map is being added and it has a different projection to any existing Tile maps, WMS base maps or WMS overlay maps you will be asked if you wish to replace the existing maps with the new WMS map.
    • When a WMS overlay map is being added and it has a different projection to any existing Tile maps, WMS base maps or WMS overlay maps you will be prevented from adding it and will need to change the selected projection for the WMS overlay map and try again.
    Note: Some projections supported by WMS are “geographic” rather than “projected” projections. Geographic projections use degrees as units and one example which is commonly used is epsg:4326. The Mapping Service used by Spectrum Spatial Analyst does not render maps in a form that aligns with geographic projections. The misalignment is more pronounced as you move further north or south from the equator. Please be aware of this limitation when choosing a geographic projection – as no warning message is shown when adding maps from the Mapping Service.
  17. Choose image format from Choose Get Map Format drop-down list. The supported Get Map format is image/png, image/gif, image/jpeg, or image/jpg.
  18. Select Keep window open to create more WMS layers check box to keep Add\Edit WMS window open.
    Note: When Keep window open to create more WMS layers checkbox is checked and Add Maps button is clicked, the selected WMS Layers is added to Map Configuration but the Add\Edit WMS Map dialog box remains open. However, all fields except Projection drop-down will get reset to their original state, when the dialog was open.
  19. Click Add to Maps button to add WMS map to map configuration.
    Note: You can either add WMS layers as business map or non-wms layers as a business map. The mapping layers will not work with WMS layers for Geographic projections. For example, epsg:4326 is a geographic projection.
  20. Click Back button to go to previous screen or click Cancel to exit Add WMS Map dialog box.

The selected map is now added to the map configuration.