WMS: Difference between revisions

From OCAD Wiki - English
Jump to navigation Jump to search
No edit summary
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[File:WMSTitle.PNG]]
'''WMS (Web Map Service)''' and '''WMTS (Web Map Tile Service)''' are interfaces for retrieving geodata as raster data over the internet.  


A Web Map Service (WMS) is a standard protocol for serving georeferenced map images over the Internet. The images are generated by a map server using data from a GIS database. (''taken from the '''[http://en.wikipedia.org/wiki/Web_Map_Service Wikipedia Article]'''.'')
These images can be used as background maps in OCAD. The images are generated by a map server using data from a GIS database.  
 
With WMTS the maps are divided into pre-generated "tiles". The background maps are thus loaded significantly faster by a WMTS service than by a WMS service.


[[File:Hint.jpg]] WMS requires a georeferenced map. Choose the '''[[Create_a_New_Map#Set_Scale_and_Coordinate_System|Scale and Coordinate System]]''' command from the '''Map''' menu to set the map scale and a coordinate system. Real world coordinates do not have to be necessarily defined. They can be left at (0/0) for example.
[[File:Hint.jpg]] WMS requires a georeferenced map. Choose the '''[[Create_a_New_Map#Set_Scale_and_Coordinate_System|Scale and Coordinate System]]''' command from the '''Map''' menu to set the map scale and a coordinate system. Real world coordinates do not have to be necessarily defined. They can be left at (0/0) for example.


To set up a map from a WMS server choose the '''WMS - Web Map Service''' command from the '''[[Background Map]]''' menu. The '''WMS - Web Map Service''' dialog appears.
To set up a map from a WMS / WMTS server choose the '''WMS / WMTS''' command from the '''[[Background Map]]''' menu. The '''WMS / WMTS''' dialog appears.


[[File:WmsDialog1.png]]
[[File:WMS.gif]]


== WMS Server ==
== WMS Server [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==


The WMS servers are listed in the upper box of the '''WMS - Web Map Service''' dialog.
The WMS servers are listed in the upper box of the '''WMS - Web Map Service''' dialog.


=== Add a WMS Server ===
: [[File:WmsDialog1.png|700px]]
 
=== Add a WMS / WMTS Server ===


# Click the '''Add''' button.
# Click the '''Add''' button.
# The '''Add WMS Server''' dialog appears.
# The '''Edit WMS / WMTS Properties''' dialog appears.
# Enter the '''Name''' of the server, the '''URL''', the '''Version''' and, if required, a '''Login''' with '''Password''', the '''Token Server URL''' and a '''Key'''.
# Enter the '''Name''' of the server, the '''URL''', the '''Version''' and, if required, a '''Login''' with '''Password''', the '''Token Server URL''' and a '''Key'''.
#: [[File:AddWMSServer.PNG]]
#: [[File:EditWMSServerProperties.PNG|500px]]
# For WMTS additional information will be shown in the '''WMTS memory cache'''.
# Click the '''OK''' button when finished.
# Click the '''OK''' button when finished.
# The WMS server appears in the WMS server box.
# The WMS server appears in the WMS server box.


=== Connect to a WMS Server ===


Select a WMS server from the list and click '''Connect'''. If the connection was successful, OCAD gets a list from the server with the available layers. These layers are listed in the WMS layer table of the '''WMS - Web Map Service''' dialog. Read the '''[[WMS#WMS_Layer|WMS Layer]]''' article to learn how to use layers as '''[[Background Map|Background Maps]]'''.


:[[File:Hint.jpg]] A bug with the error message 'Could Not Load SSL Library' is fixed since OCAD 11.1.7.1385.
=== Connect to a WMS / WMTS Server ===
:[[File:Hint.jpg]] Internet connection via proxy server is supported since OCAD 12.1.2.


: [[File:WMSDialog2.PNG]]
Select a WMS / WMTS server from the list and click '''Connect'''. If the connection was successful, OCAD gets a list from the server with the available layers. These layers are listed in the WMS / WMTS layer table of the '''WMS / WMTS''' dialog. Read the '''[[WMS#WMS / WMTS_Layer|WMS / WMTS Layer]]''' article to learn how to use layers as '''[[Background Map|Background Maps]]'''.


=== Edit WMS Server Properties ===


Select a WMS server and click the '''Edit''' button to edit its properties. The '''Edit WMS Server Properties''' dialog appears which is equal to the '''[[WMS#Add a WMS Server|Add WMS Server]]''' dialog.
[[File:WMSDialog2.PNG|700px]]
: [[File:EditWMSServerProperties.PNG]]


=== Remove a WMS Server ===
=== Edit WMS / WMTS Server Properties ===


Click the '''Remove''' button to remove the selected WMS server from the list.
Select a WMS / WMTS server and click the '''Edit''' button to edit its properties. The '''Edit WMS / WMTS Properties''' dialog appears which is equal to the '''[[WMS#Add a WMS Server|Add WMS / WMTS Server]]''' dialog.
== WMS Layer ==
: [[File:EditWMSServerProperties.PNG|500px]]
After connecting to a WMS server the available WMS layers are listed in the WMS layer box.
# Choose the '''Image format'''.
# Choose one of these options:
#* '''[[WMS#Add_Selected_Layers_as_WMS_Layers_to_Background_Maps_.28Online.29|Add selected layers as WMS layers to background maps (Online)]]'''
#* '''[[WMS#Add_Current_View_of_Selected_Layers_to_Background_Maps_.28Offline.29|Add current view of selected layers to background maps (Offline)]]'''
#* '''[[WMS#Add_User_Defined_Extent_of_Selected_Layers_to_Background_Maps_.28Offline.29|Add user defined extent of selected layers to background maps (offline)]]'''
# Define an '''Offline folder''' if one of the offline options is chosen.
# Define the '''Extent''' (minimum easting, maximum easting, minimum northing, maximum northing) and the '''Resolution''' if the option '''Add user defined extent of selected layers to background maps (offline)''' is chosen.
#: [[File:Hint.jpg]] The current view extent is set as a default opening the WMS dialog but not updated automatically by changing the view. The extent can be updated by clicking the '''Set extent to current view''' button.


[[File:WMSDialog3.PNG]]
=== Remove a WMS / WMTS Server ===


[[File:Hint.jpg]] Web Map Services generally provide their images in multiple spatial reference systems. OCAD can only access to WMS if the OCAD maps' coordinate system (ex. Swiss Grid CH1903) is supported by the WMS. Then the '''Spatial reference system''' is automatically set to the corresponding EPSG code. If the chosen coordinate system is not compatible with the WMS, the '''Spatial reference system''' box at the lower part of the dialog remains empty.
Click the '''Remove''' button to remove the selected WMS / WMTS server from the list.


== WMS / WMTS Layer ==
After connecting to a WMS / WMTS server the available WMS / WMTS layers are listed in the WMS / WMTS layer box.
: [[File:WMSDialog3.PNG|700px]]


=== Add Selected Layers as WMS Layers to Background Maps (Online) ===
# Select a WMS / WMTS layer in the list and choose an '''Image format''' from dropdown list (those formats are provided by the WMS / WMTS server).
[[File:WmsAddLayerOnline.png]] <br>
# Choose an option how to add the selected layers:
Select a WMS layer in the list, choose an '''Image format''' from dropdown list (those formats are provided by the WMS server), the option '''Add selected layers as WMS layers to background maps (online)''' and click the add button.
#* '''Add Selected Layers as WMS / WMTS Layers to Background Maps (Online)'''
: [[File: hint.jpg]] The '''Background map (Geo-Referenced)''' dialog appears if no real world coordinates offset is set. Choose an offset and click the '''OK''' button.
#:: [[File:WmsAddLayerOnline.png|500px]]
 
#:: This is an online '''[[Background Map]]''' . It is updated by the WMS / WMTS Server by each change of the map view. This can take a moment. Choose the ''online'' option only if you are using a fast WMS / WMTS server and work woth high speed internet connection. As an alternative, you can add the layer as an offline background map.
The WMS layer appears in the table of the '''Manage Background Map''' dialog which can be displayed in the '''[[Background Map]]''' menu.
#* '''Add current view of selected layers to background maps (Offline)'''
 
#:: [[File:WmsAddCurrentViewOffline.png|500px]] <br>
This is an online '''[[Background Map]]'''. Everytime the view of the map is changed, the '''[[Background Map]]''' gets updated from the WMS server. Updating the online '''Background Map''' can take a moment. Choose the online '''Background Map''' option only if you are using a fast WMS server and a high speed internet connection. As an alternative, you can add the layer as an offline '''[[Background Map]]'''.
#::* Define the '''Offline folder'''. The current map folder is set as default.
 
#:: With this offline option an image of the chosen WMS / WMTS layer of the current view is downloaded from the WMS / WMTS server and added as a custom background map to the map. It does not get updated when changing the view.
=== Add Current View of Selected Layers to Background Maps (Offline) ===
#* '''Add User Defined Extent of Selected Layers to Background Maps (Offline)'''
[[File:WmsAddCurrentViewOffline.png]] <br>
#:: [[File:WmsAddUserDefinedExtentOffline.png|500px]] <br>
Select a WMS layer in the list, choose an '''Image format''' from the dropdown list (those formats are provided by the WMS server), choose the option '''Add current view of selected layers to background maps (offline)''' and click the '''Add''' button.  
#::* Define the '''Offline folder'''. The current map folder is set as default.
: [[File:hint.jpg]] The '''Background map (Geo-Referenced)''' dialog appears if no real world coordinates offset is set. Choose an offset and click the '''OK''' button.
#::* Define the '''Resolution'''.
 
#::* Define the '''Extent''' (minimum easting, maximum easting, minimum northing, maximum northing). The current view extent is set as a default when opening the WMS / WMTS dialog but the entries are not updated automatically by changing the view. The extent can be updated by clicking the '''Set extent to current view''' button.
The WMS layer appears in the table of the '''[[Background_Map#Manage_Background_Maps|Manage Background Map]]''' dialog which can be displayed in the '''[[Background Map]]''' menu.
#:: With this offline option an image of the chosen WMS / WMTS layer of the defined extent is downloaded from the WMS / WMTS server and added as a custom background map to the map. It does not get updated when changing the view.
 
# Click the '''Add''' button.
This is an offline '''[[Background Map]]'''. An image of the chosen WMS layer of the current view was downloaded from the WMS server and is now available as a custom background map in OCAD. It does not get updated when changing the view.
#:: The WMS / WMTS layer appears in the table of the '''[[Background_Map#Manage_Background_Maps|Manage Background Map]]''' dialog which can be displayed in the '''[[Background Map]]''' menu.
 
#:: [[File: hint.jpg]] The '''Background map (Geo-Referenced)''' dialog appears if no real world coordinates offset is set. Choose an offset and click the '''OK''' button.
 
<br><br>
 
[[File:Hint.jpg]] Web Map Services generally provide their images in multiple spatial reference systems. OCAD can only access to WMS / WMTS if the OCAD maps' coordinate system (ex. Swiss Grid CH1903+/LV95) is supported by the WMS / WMTS. Then the '''Spatial reference system''' is automatically set to the corresponding EPSG code. If the chosen coordinate system is not compatible with the WMS / WMTS, the '''Spatial reference system''' caption in the WMS / WMTS dialog remains empty.
Click the '''Close''' button when finished. You can manage the view or remove the WMS maps by choosing the '''[[Background_Map#Manage_Background_Maps|Manage]]''' command from the '''[[Background Map]]''' menu.
<br><br>
 
Click the '''Close''' button when finished.<br><br>
[[File:WMSBackGroundMap.PNG]]
[[File:Hint.jpg]] Manage the view or remove the WMS maps by choosing the '''[[Background_Map#Manage_Background_Maps|Manage]]''' command from the '''[[Background Map]]''' menu:<br>
 
[[File:WMSBackGroundMap.PNG|700px]]
Examples to display the map:<br />
 
 
[[File:WMSExample.PNG|1000px]]<br />
[[File:WMS4.png|1000px]]


----
'''WMS Examples''':<br />
Back to the '''[[Background Map]]''' page.
[[File:WMSExample.PNG|700px]]<br /><br />
[[File:WMS4.png|700px]]

Revision as of 17:46, 4 November 2020

WMS (Web Map Service) and WMTS (Web Map Tile Service) are interfaces for retrieving geodata as raster data over the internet.

These images can be used as background maps in OCAD. The images are generated by a map server using data from a GIS database.

With WMTS the maps are divided into pre-generated "tiles". The background maps are thus loaded significantly faster by a WMTS service than by a WMS service.

Hint.jpg WMS requires a georeferenced map. Choose the Scale and Coordinate System command from the Map menu to set the map scale and a coordinate system. Real world coordinates do not have to be necessarily defined. They can be left at (0/0) for example.

To set up a map from a WMS / WMTS server choose the WMS / WMTS command from the Background Map menu. The WMS / WMTS dialog appears.

WMS.gif

WMS Server Space.PNGThis function is available in OCAD Mapping Solution.This function is available in OCAD Orienteering.

The WMS servers are listed in the upper box of the WMS - Web Map Service dialog.

WmsDialog1.png

Add a WMS / WMTS Server

  1. Click the Add button.
  2. The Edit WMS / WMTS Properties dialog appears.
  3. Enter the Name of the server, the URL, the Version and, if required, a Login with Password, the Token Server URL and a Key.
    EditWMSServerProperties.PNG
  4. For WMTS additional information will be shown in the WMTS memory cache.
  5. Click the OK button when finished.
  6. The WMS server appears in the WMS server box.


Connect to a WMS / WMTS Server

Select a WMS / WMTS server from the list and click Connect. If the connection was successful, OCAD gets a list from the server with the available layers. These layers are listed in the WMS / WMTS layer table of the WMS / WMTS dialog. Read the WMS / WMTS Layer article to learn how to use layers as Background Maps.


WMSDialog2.PNG

Edit WMS / WMTS Server Properties

Select a WMS / WMTS server and click the Edit button to edit its properties. The Edit WMS / WMTS Properties dialog appears which is equal to the Add WMS / WMTS Server dialog.

EditWMSServerProperties.PNG

Remove a WMS / WMTS Server

Click the Remove button to remove the selected WMS / WMTS server from the list.

WMS / WMTS Layer

After connecting to a WMS / WMTS server the available WMS / WMTS layers are listed in the WMS / WMTS layer box.

WMSDialog3.PNG
  1. Select a WMS / WMTS layer in the list and choose an Image format from dropdown list (those formats are provided by the WMS / WMTS server).
  2. Choose an option how to add the selected layers:
    • Add Selected Layers as WMS / WMTS Layers to Background Maps (Online)
    WmsAddLayerOnline.png
    This is an online Background Map . It is updated by the WMS / WMTS Server by each change of the map view. This can take a moment. Choose the online option only if you are using a fast WMS / WMTS server and work woth high speed internet connection. As an alternative, you can add the layer as an offline background map.
    • Add current view of selected layers to background maps (Offline)
    WmsAddCurrentViewOffline.png
    • Define the Offline folder. The current map folder is set as default.
    With this offline option an image of the chosen WMS / WMTS layer of the current view is downloaded from the WMS / WMTS server and added as a custom background map to the map. It does not get updated when changing the view.
    • Add User Defined Extent of Selected Layers to Background Maps (Offline)
    WmsAddUserDefinedExtentOffline.png
    • Define the Offline folder. The current map folder is set as default.
    • Define the Resolution.
    • Define the Extent (minimum easting, maximum easting, minimum northing, maximum northing). The current view extent is set as a default when opening the WMS / WMTS dialog but the entries are not updated automatically by changing the view. The extent can be updated by clicking the Set extent to current view button.
    With this offline option an image of the chosen WMS / WMTS layer of the defined extent is downloaded from the WMS / WMTS server and added as a custom background map to the map. It does not get updated when changing the view.
  3. Click the Add button.
    The WMS / WMTS layer appears in the table of the Manage Background Map dialog which can be displayed in the Background Map menu.
    Hint.jpg The Background map (Geo-Referenced) dialog appears if no real world coordinates offset is set. Choose an offset and click the OK button.



Hint.jpg Web Map Services generally provide their images in multiple spatial reference systems. OCAD can only access to WMS / WMTS if the OCAD maps' coordinate system (ex. Swiss Grid CH1903+/LV95) is supported by the WMS / WMTS. Then the Spatial reference system is automatically set to the corresponding EPSG code. If the chosen coordinate system is not compatible with the WMS / WMTS, the Spatial reference system caption in the WMS / WMTS dialog remains empty.

Click the Close button when finished.

Hint.jpg Manage the view or remove the WMS maps by choosing the Manage command from the Background Map menu:
WMSBackGroundMap.PNG

WMS Examples:
WMSExample.PNG

WMS4.png