Knowledge Base
Recent Changes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
dev:technology:supported_formats:image:owxs [2017/06/06 09:45]
jve@orbitgt.com 		dev:technology:supported_formats:image:owxs [2023/10/06 16:56] (current)
mihaela [Create]
Line 1: Line 1:
 ====== Orbit Web service file ====== ====== Orbit Web service file ======
  
-An Orbit Web service resource connection file is a filed based connection to one specific layer of a well defined web service.+An Orbit Web service resource connection file is a file reference to one specific layer of a well defined web service. \\ 
 +It is advised to read first the documentation about [[dev:technology:core:web_resources|]].
  
 Connection file by web service type :  Connection file by web service type : 
Line 8: Line 9:
   * *.owfs : Orbit Web Feature Service   * *.owfs : Orbit Web Feature Service
  
-It is strongly advised to read  the documentation about [[technology:core_concepts:web_resources|]].+===== Structure =====
  
 +An Orbit Web service resource connection file has the following structure:
  
-=== Structure ===+Required configurations 
 +  * ''ServerType'' : ''WMS'', ''WMTS'' or ''WFS''. 
 +  * ''ServerName'' : Free of choice, but do not use "." character. Web service name as labeled in Orbit. 
 +  * ''ServerURL'' : service url 
 +  * ''DataSetName'' : <layer name> or <layer order reference> 
 +    * <layer name> : Value of service FeatureType Name tag in the FeatureTypeList. 
 +    * <layer order reference> : "[i]", "i" is the order of the layer it the web service FeatureTypeList. (only for OWFS).
  
-An Orbit Web service resource connection file has the following structure:+Optional configurations 
 +  * ''UserName'' : Username credentials if applicable. 
 +  * ''Password'' : Password credentials if applicable. 
 +  * ''swap_axis'' : Comma separated list of EPSG codes. Set list of CRS for map requests coordinates need to be inverted.  
 +  * ''PreferredCRS'' : EPSG Code. Set fix CRS for all web service communication and map requests. (Only for OWMTS) 
 +  * ''StaticContent'' :  ''true'' or ''false'', default false. (Only for OWFS) \\ If true, then all features are loaded at once and saved in memory. The initial feature request will take more time, but once loaded there are no more web requests needed. This setting is perfect for smaller and static WFS layers to avoid continuous time-consuming web requests. \\ If false, then features are loaded on-the-fly as needed corresponding to the map view. Setting for larger and/or dynamic WFS layers.  
 +  * ''FallbackGeometryPropertyType'' : ''PointPropertyType'', ''LineStringPropertyType'' or ''PolygonPropertyType''.  (Only for OWFS) \\ Specification of the feature's spatial type (geometry) is mandatory only if the service is not specifying the geometry or identifying the spatial type as generic geometry. 
 +  * ''Is3D'' : ''true'' or ''false'', setting to request 2D or 3D vector features, default false (Only for OWFS). 
 +  * ''IgnoreDCP'':  ''true'' or ''false'', setting to ignore the post requests URLs as specified in the service's capabilities file. Orbit will use the capabilities URL for all requests. Default false. 
 +  * ''UpdateMode'': ''READONLY'' or ''FULL_CONTROL'' for WFS-T, default is ''FULL_CONTROL''
  
-  * ServerType : "WMS", "WMTS" or "WFS". 
-  * ServerName : free of choice - Web service name as labeled in Orbit. 
-  * ServerURL : service url 
-  * DataSetName : <layer name> or <layer order reference> 
-    * <layer name> : value of service FeatureType Name tag in the FeatureTypeList. 
-    * <layer order reference> : "[i]", were i is the order of the layer it the web service FeatureTypeList. 
-  * UserName : username credentials if applicable. 
-  * Password : password credentials if applicable. 
-  * PreferredCRS : <EPSG code> - optionally for WMTS only -  set fix coordinate reference system to be used. 
-  * StaticContent :  "true" or "false" - optionally for WFS only - optimize caching and reduce web feature requests. 
  
-=== Reason to use ===+===== Reason to use =====
  
-Compared to establishing a web service connection and loading the layer via the [[170:desktop:workspace:resource_library|Resource Browser]], this alternative way of loading a web service layer has following advantages :  +A Web Service reference file simplifies use of Web resources and enables additional configurations : 
-  * Web service layers are manageable as file based resources like other supported formats. +  * Manage and share web resource in the same way as regular, file based resources. 
-  * Easy to share with Orbit users. +  * Associate an [[dev:technology:supported_formats:other:olg|Orbit Legend file]].  
-  * Possibility to create and associate an [[technology:supported_formats:other:olg|Orbit Legend]]. +  * Set additional service configurations, see Structure. 
-  * Additional configuration possibilities like preferred crs, static content and spatial format, see below.+
  
-=== Create ===+===== Create =====
  
-Create and edit these files using a text editor. Take care of spelling and file syntax.+Create and edit the .owfs, .owms and .owmts files using a simple text editor (e.g. Notepad).  Take care of spelling and file syntax.
  
-=== Examples ===+Exemples of owfs configurations > to be saved in a .owfs file \\ 
 +''ServerType:WFS \\ 
 +ServerURL:https://msdi.data.gov.mt/geoserver/MITA_WFS_SR_GeoSubArea/wfs \\ 
 +ServerName:geoserver \\ 
 +DataSetName:MITA_WFS_SR_GeoSubArea:SR.SeaArea.GSA15.WFS \\ 
 +PreferredCRS:3045'' \\
  
-<code> +Exemples of owms configurations > to be saved in a .owms file \\ 
-ServerType WMS +''ServerType=WMS \\ 
-ServerName NASA JPL +ServerName=wms.geo.gr.ch \\ 
-ServerURL http://wms.jpl.nasa.gov/wms.cgi?Service=WMS&Version=1.1.1&Request=GetCapabilities +ServerURL=https://wms.geo.gr.ch/kstn_strassenentwaesserung?Service=WMS&Request=GetCapabilities&Version=1.0.0 \\ 
-DataSetName global_mosaic +DataSetName=Eigentuemer_Belagsschale''\\
-UserName  +
-Password  +
-</code>+
  
-<code> 
-ServerType WMTS 
-ServerName Agiv_WTMS 
-ServerURL http://grb.agiv.be/geodiensten/raadpleegdiensten/geocache/wmts?service=WMTS 
-DataSetName ortho2007 
-UserName  
-Password  
-PreferredCRS 31370  
-</code> 
  
-<code> 
-ServerType WFS 
-ServerName www.ruimtemonitor.be 
-ServerURL http://www.ruimtemonitor.be/geoserver/rm/wfs?service=wfs&request=getcapabilities&version=1.1.0 
-DataSetName rm:m06_woonwerkafstand_mmm 
-UserName  
-Password  
-</code> 
 
Last modified:: 2018/06/21 08:13