====== Orbit Web service file ======

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 [[209:technology:core:web_resources|]].

Connection file by web service type : 
  * *.owms : Orbit Web Map Service
  * *.owmts : Orbit Web Map Tile Service
  * *.owfs : Orbit Web Feature Service

=== Structure ===

An Orbit Web service resource connection file has the following 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).

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 perfect for smaller and static wfs layers to avoid continious time consuming web requests. \\ If false, then features are loaded on-the-fly as needed corresponding 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.

=== Reason to use ===

A Web Service reference file simplifies use of Web resources and enables additional configurations :
  * Manage and share web resource in the same way as regular, file based resources.
  * Associate an [[209:technology:supported_formats:other:olg|Orbit Legend file]]. 
  * Set additional service configurations, see Structure. 

=== Create ===

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 ===

** Belgium Informatie Vlaanderen Ortho ** \\
https://overheid.vlaanderen.be/Webdiensten-Raadpleegdiensten \\
https://geoservices.informatievlaanderen.be/raadpleegdiensten/omwrgbmrvl/wms?service=wms&request=getcapabilities \\
{{:209:technology:supported_formats:image:informatievlaanderen_ortho_.zip|}}

<code>
ServerType	WMS
ServerName	informatievlaanderen_omwrgbmrvl
ServerURL	https://geoservices.informatievlaanderen.be/raadpleegdiensten/omwrgbmrvl/wms?
DataSetName	Ortho
</code>

<code>
ServerType	WFS
ServerName	informatievlaanderen_vrbg
ServerURL	Https://geoservices.informatievlaanderen.be/overdrachtdiensten/Vrbg/wfs?r
DataSetName	VRBG:Refarr
StaticContent true
</code>

https://tile.informatievlaanderen.be/ws/raadpleegdiensten/wmts?request=getcapabilities&service=wmts&version=1.0.0 \\
{{:209:technology:supported_formats:image:informatievlaanderen_ortho_wmts.zip|}}

<code>
ServerType	WMTS
ServerName	informatievlaanderen_raadpleegdiensten_wmts
ServerURL	http://tile.informatievlaanderen.be/ws/raadpleegdiensten/wmts?
DataSetName	omwrgbmrvl
UserName	
Password	
PreferredCRS	31370
</code>

http://geoservices.informatievlaanderen.be/overdrachtdiensten/GRB/wfs?service=wms&request=getcapabilities \\
{{:209:technology:supported_formats:image:informatievlaanderen_grb_gbg.zip|}}

<code>
ServerType	WFS
ServerName	informatievlaanderen_grb
ServerURL	http://geoservices.informatievlaanderen.be/overdrachtdiensten/GRB/wfs?
DataSetName	[3]
</code>

** Poland Geoportal Orto ** \\
http://www.geoportal.gov.pl/uslugi/usluga-przegladania-wms \\
http://mapy.geoportal.gov.pl/wss/service/img/guest/ORTO/MapServer/WMSServer?service=wms&request=getcapabilities \\
{{:209:technology:supported_formats:image:poland_geoportal_orto.zip|}}

<code>
ServerType	WMS
ServerName	mapy_geoportal_gov_pl_orto
ServerURL	http://mapy.geoportal.gov.pl/wss/service/img/guest/ORTO/MapServer/WMSServer
DataSetName	Raster
swap_axis	4326,2180,2176,2177,2178,2179
</code>

** US Geological Survey ** \\
https://www.usgs.gov/ \\
https://isse.cr.usgs.gov/arcgis/services/Orthoimagery/USGS_EROS_Ortho_1Foot/ImageServer/WMSServer?service=wms&request=getcapabilities \\
{{:209:technology:supported_formats:image:usgs_eros_ortho_1foot.zip|}}

<code>
ServerType	WMS
ServerName	USGS_EROS_Ortho
ServerURL	https://isse.cr.usgs.gov/arcgis/services/Orthoimagery/USGS_EROS_Ortho_1Foot/ImageServer/WMSServer
DataSetName	USGS_EROS_Ortho_1Foot
</code>

** US Nasa Earth Observation ** \\
https://neo.sci.gsfc.nasa.gov/ \\
https://neo.sci.gsfc.nasa.gov/wms/wms?service=wms&request=getcapabilities \\

<code>
ServerType	WMS
ServerName	NEO
ServerURL	https://neo.sci.gsfc.nasa.gov/wms/wms
DataSetName	SRTM_RAMP2_TOPO
</code>