WMS: Difference between revisions

From OCAD Wiki - English
Jump to navigation Jump to search
 
(20 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. The images are generated by a map server using data from a GIS database.


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.


[[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.
*A '''WMS''' is calculated on the server side and delivers one image per request.
*A '''WMTS''' delivers tiles that have been pre-renderd on the server side, and cached on the client side. The background maps are thus loaded significantly faster by a WMTS service than by a WMS service.


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.
[[File:Hint.jpg]] WMS / WMTS 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.<br>
Real world coordinates do not have to be necessarily defined. They can be left at (0/0) for example.


[[File:WmsDialog1.png]]


== WMS Server ==
[[File:WMS.gif]]


The WMS servers are listed in the upper box of the '''WMS - Web Map Service''' dialog.
== 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]]==


=== Add a WMS Server ===
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.


# Click the '''Add''' button.
The WMS servers are listed in the upper left box of the '''WMS - Web Map Service''' dialog.
# The '''Add WMS Server''' 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'''.
#: [[File:AddWMSServer.PNG]]
# Click the '''OK''' button when finished.
# The WMS server appears in the WMS server box.


=== Connect to a WMS Server ===
There are already some preset connections the first time you start the dialogue.


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:WmsDialog1.png|700px]]


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


: [[File:WMSDialog2.PNG]]
# Click the '''Add''' button.
# The '''Edit WMS / WMTS Properties''' dialog appears.
# Enter the '''Service''', '''Name''' of the server, the '''URL''' and choose the '''Version'''<br> If required, also provide a '''Login''' with '''Password''', the '''Token Server URL''' and a '''Key'''.<br>You will get these data from the WMS /WMTS provider.
#: [[File:EditWMSServerProperties.PNG|500px]]
# For WMTS additional information will be shown in the '''WMTS memory cache'''.
# Click the '''OK''' button when finished.
# The WMS / WMTS server appears in the upper left WMS / WMTS server box.


=== Edit WMS Server Properties ===
=== Connect to a WMS / WMTS Server ===


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.
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]]'''.
: [[File:EditWMSServerProperties.PNG]]


=== Remove a WMS Server ===


Click the '''Remove''' button to remove the selected WMS server from the list.
[[File:WMSDialog2.PNG|700px]]
== WMS Layer ==
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]]
=== Edit WMS / WMTS Server Properties ===


[[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.
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.
: [[File:EditWMSServerProperties.PNG|500px]]


=== Remove a WMS / WMTS Server ===


=== Add Selected Layers as WMS Layers to Background Maps (Online) ===
Click the '''Remove''' button to remove the selected WMS / WMTS server from the list.


Select a WMS layer in the list, choose an image format in the '''Image format''' dropdown list (those formats are provided by the WMS server) and click the '''Add selected layers as WMS layers to background maps (online)''' button. If no real world coordinates are set, the '''Background map (Geo-Referenced)''' dialog appears. Choose an offset and click the '''OK''' button.
== WMS / WMTS Layer ==


The WMS layer appears in the table of the '''Manage Background Map''' dialog which can be displayed in the '''[[Background Map]]''' menu.
===Add Selected Layers to Background Maps===
 
After connecting to a WMS / WMTS server the available WMS / WMTS layers are listed in the WMS / WMTS layer box.  
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]]'''.
: [[File:WMSDialog3.PNG|700px]]
 
=== Add Current View of Selected Layers to Background Maps (Offline) ===
 
Select a WMS layer in the list, choose an image format in the '''Image format''' dropdown list (those formats are provided by the WMS server) and click the '''Add current view of selected layers to background maps (offline)''' button. If no real world coordinates are set, the '''Background map (Geo-Referenced)''' dialog appears. Choose an offset and click the '''OK''' 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.
 
This is an offline '''[[Background Map]]'''. An image of the chosen WMS layer of the current view was donwloaded from the WMS server and is now available in OCAD. The '''[[Background Map]]''' does not get updated when changing the view.
 
 
 
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.
 
[[File:WMSBackGroundMap.PNG]]
 
Examples to display the map:<br />


# 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). There is also a Search Field.
# Choose an option how to add the selected layers:
#* '''Add Selected Layers as WMS / WMTS Layers to Background Maps (Online)'''
#:: [[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.
#* '''Add current view of selected layers to background maps (Offline)'''
#:: [[File:WmsAddCurrentViewOffline.png|500px]] <br>
#::* 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)'''
#:: [[File:WmsAddUserDefinedExtentOffline.png|500px]] <br>
#::* 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.
# Click the '''Add''' button.
#:: 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.
<br><br>
Click the '''Close''' button when finished.<br><br>


[[File:WMSExample.PNG|1000px]]<br />
===Remove Selected Layers from Background Maps===
[[File:WMS4.png|1000px]]
To remove a WMS / WMTS layer or to manage its view, choose the '''[[Background_Map#Manage_Background_Maps|Manage]]''' command from the '''[[Background Map]]''' menu:<br>
[[File:WMSBackGroundMap.PNG|700px]]


----
===WMS Examples===
Back to the '''[[Background Map]]''' page.
[[File:WMS ForestReserve.png]]<br>
''WMS layer indicating forest reserves that may not be entered.''
<br><br>
[[File:WMS CadastralSurvey.png]]<br>
''WMS layer that contains cadastral survey data.''

Latest revision as of 15:53, 23 August 2023

WMS (Web Map Service) and WMTS (Web Map Tile Service) are interfaces for retrieving geodata as raster data over the internet. The images are generated by a map server using data from a GIS database.

These images can be used as background maps in OCAD.

  • A WMS is calculated on the server side and delivers one image per request.
  • A WMTS delivers tiles that have been pre-renderd on the server side, and cached on the client side. The background maps are thus loaded significantly faster by a WMTS service than by a WMS service.

Hint.jpg WMS / WMTS 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.


WMS.gif

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

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.

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

There are already some preset connections the first time you start the dialogue.

WmsDialog1.png

Add a WMS / WMTS Server

  1. Click the Add button.
  2. The Edit WMS / WMTS Properties dialog appears.
  3. Enter the Service, Name of the server, the URL and choose the Version
    If required, also provide a Login with Password, the Token Server URL and a Key.
    You will get these data from the WMS /WMTS provider.
    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 / WMTS server appears in the upper left WMS / WMTS 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

Add Selected Layers to Background Maps

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). There is also a Search Field.
  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.

Remove Selected Layers from Background Maps

To remove a WMS / WMTS layer or to manage its view, choose the Manage command from the Background Map menu:
WMSBackGroundMap.PNG

WMS Examples

WMS ForestReserve.png
WMS layer indicating forest reserves that may not be entered.

WMS CadastralSurvey.png
WMS layer that contains cadastral survey data.