This is documentation of an archived release.
For documentation on the current version, please check Knowledge Base.

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 Web-based 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 Orbit Resource Descriptor 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 256×256 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

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

For WMTS

Format=WMTS
MapUrl=http://tile.informatievlaanderen.be/ws/raadpleegdiensten/wmts?
Layer=grb_bsk
PreferredCRS=31370
UserName=
Password=
Format=WMS
MapUrl=https://geoservices.informatievlaanderen.be/raadpleegdiensten/omwrgbmrvl/wms?
Layer=Ortho
CRS=31370
PixelSize=0.5
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
 
Last modified:: 2023/05/12 16:31