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

It is advised to read first the documentation about [[227:technology:core:web_resources|]].

For more information, see [[227:userdoc:import|workflow]] on web server connection.

===== Web Services in HTML5 webclient =====

Direct connection to WMS\WMTS is not possible for HTML5 webclient. The OTM (Orbit TileMap) is an abstract image format that supports reading and rendering online image data.\\

It has several advantages in comparison with direct connection to a 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 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 [[227: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.

The following configuration parameters need to be defined in the '.otm' file for WMS service:
<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>

The following configuration parameters need to be defined in the '.otm' file for WMTS service:
<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>

Parameters present in *.otm file:
  * ''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
  * ''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 the default color black transparent. When another color should be transparent, use the parameter ''TransparentColor''. For example, TransparentColor = 255.255.255 to make white as transparent. 
  * ''UseAlphaChannel'': Set to True when the loaded tiles have alpha transparency. 

<note tip>Check the capabilities document of the WM(T)S server to find the right parameter values.\\
For WMS server append "?REQUEST=GetCapabilities" to the URL to download this xml document.\\
For WMTS append "?Service=WMTS&Request=GetCapabilities&Version=1.0.0" to the URL to download this xml document.\\
\\
example:\\
http://maps.wien.gv.at/basemap/1.0.0/WMTSCapabilities.xml?Service=WMTS&Request=GetCapabilities&Version=1.0.0</note>