====== Tiled Map Configuration for Web Map Services ======

This page documents the specific configurations for Web Map and Web Map Tiled Services for Orbit 3DM Viewer. \\
It is advised to read first the documentation about [[2210:technology:core:web_resources|]].

===== Concepts =====

==== Web Map Services in 3DM Viewer ====

WMS and WMTS display in the 3DM Viewer use the Orbit Tiled Map (OTM) driver, as an abstract layer to consume the Web Map Services.

It has several advantages in comparison with a direct connection of the remote resource:
  * Unlike direct connection it requests not just an image of a current window in rendered on-the-fly resolution but tiles of 256*256 pixels on a certain level of the pyramid which allows both: faster rendering and cashing of loaded data.
  * Possibility to transform loaded tiles and visualize them in any Map CRS.

The resource should be accompanied by an [[2210:technology:supported_formats:other:ord|]] file. \\
The resource coordinate system must be defined via the associated .ord file, just like other regular file-based resources.

===== Configurations  =====

*.otm Configuration Parameters

=== Required ===

  * ''CRS'' : (Preferred)CRS should be chosen from the list of the projections enabled for the corresponding web service. If it's expected that the Map CRS mostly used for this data will be one of the enabled CRSs of the webservice then it's recommended to use it to avoid extra transformations as this is the CRS in which tiles will be rendered in.
  * ''PixelSize'' : Pixel size is used by OTM\WMS driver to create a pyramid of 256x256 pixel tiles, it also is a maximum detail size of the pixel to render (resolution of this abstract image).
  * ''Layer'' : Layer name Value of service FeatureType Name tag in the FeatureTypeList

=== Optional ===

  * ''ImageFormat'': specification of the tiles image format is mandatory if the tiles format is not .png as Orbit expects by default .png format; <image format> Value of service FeatureType Format tag in the FeatureTypeList.
  * ''DiskCacheName'': name of the folder that is used when caching 
  * ''UseTransparentColor'': Set to ''true'' to make "black" transparent. \\ ''TransparentColor'': Set any other color transparent e.g. 255.255.255 to make white as transparent. 
  * ''UseAlphaChannel'': Set to ''true'' when the loaded tiles have alpha transparency. 

===== Examples =====

For WMS

<code>
Format=WMS
MapUrl=http://kartor.stockholm.se:80/bios/wms/app/baggis/web/WMS_STHLM_STOCKHOLMSKARTA_GRA_FORENKLAD_RASTER?
ImageFormat=image/jpg
Layer=p_1002800
CRS=3011
PixelSize=0.5
</code>

For WMTS

<code>
Format=WMTS
MapUrl=http://tile.informatievlaanderen.be/ws/raadpleegdiensten/wmts?
Layer=grb_bsk
PreferredCRS=31370
UserName=
Password=
</code>

<code>
Format=WMS
MapUrl=https://geoservices.informatievlaanderen.be/raadpleegdiensten/omwrgbmrvl/wms?
Layer=Ortho
CRS=31370
PixelSize=0.5
</code>


<note tip>
Request Capabilities
\\ \\
Check the capabilities of the web services to find get the configuration values.\\
<server URL>?Service=WMS&Request=GetCapabilities&Version=1.3.0 \\
<server URL>?Service=WMTS&Request=GetCapabilities&Version=1.3.0
\\
example:\\
http://maps.wien.gv.at/basemap/1.0.0/WMTSCapabilities.xml?Service=WMTS&Request=GetCapabilities&Version=1.0.0
</note>