WFS: Difference between revisions

From Tygron Preview Support Wiki
Jump to navigation Jump to search
mNo edit summary
 
(54 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{being updated}}
[[File:WFS_BAG_geo_data_wizard_features.jpg|thumb|right|Identifying importable BAG features for a [[project area]] using the [[Geo Data Wizard]].]]
{{learned|what a WFS is|how to insert a WFS into the Engine}}
A Web Feature Service, in short WFS, is an [https://www.ogc.org/ OGC] standard in where data is published and can be downloaded in (geo) data formats specified by the service.


==What is a WFS==
Spatial data can be obtained by querying the service with additional parameters, specifying the request, version, layer and option bounding box, data format and coordinate system. Generally these requests can be performed using a browser or GET requests, on a WFS endpoint and with the additional parameters stated as query parameters.  
A Web Feature Service, in short WFS, is a standard in where data is published to the Internet and can be downloaded in different (geo) data formats. This standard is defined by the OGC, the Open Geospatial Consortium. The data is accessible through an URL and works in any browser. To read the metadata, filter data or download it, you can just use your browser. To visualize the data, the URL of the WFS can be read by a GIS (Geographical Information System). One of the advantages of a WFS is that the data is accessible on the internet, so you can always access it (if there is internet) and you don’t have to carry files with you anymore. Also sharing data is more easily, since you just have to provide the WFS URL, instead of the data file.


==How to insert a WFS in the Engine==
Data provided by these requests can be visualized by a GIS (Geographical Information System) software such as the {{software}}, [[QGIS]], [[ArcGIS Pro]] and [[ArcGIS Online]].
There are already a few WFS provided by default to load data from. These are already used by the Engine, among other datasets, to create a new project with.
 
One of the advantages of a WFS is that the data is accessible on the internet, so you can always access it (if there is internet) and you don’t have to carry files with you anymore. Also sharing data is more easily, since you just have to provide the WFS URL.
{{clear}}
 
==WFS sources used in the {{software}}==
[[File:WFS_BAG_source_in_project.jpg|thumb|right|BAG Source present in a project.]]
Each project created in the {{software}} has [[Project_Sources|several default sources]] that store references to public Web Feature Services. When a Project is created for the Netherlands, some of these Web Feature Services are used to populate a project with Buildings, Terrains, Neighborhoods etc. These are:
* BAG: the base registration for Addresses and Buildings in the Netherlands.  
* BAG: the base registration for Addresses and Buildings in the Netherlands.  
* BRP: Gewaspercelen, a Dutch dataset containing the type of crops.
* BRP: Gewaspercelen, a Dutch dataset containing the type of crops.
* CBS Buurten: CBS Wijk en Buurtkaart; a Dutch dataset from the CBS containing the geometries of neighborhoods in the Netherlands and statistical data about these neighborhoods.  
* CBS Buurten: CBS Wijk en Buurtkaart; a Dutch dataset from the CBS containing the geometries of neighborhoods in the Netherlands and statistical data about these neighborhoods.  
* FGR: Fysisch geografische regio's; a Dutch dataset containing the types of land
* FGR: Fysisch geografische regio's; a Dutch dataset containing the types of land.
 
It is also possible to add new Web Feature Service links to your project, as [[Source]]s, and use these to obtain vector data to add to your project:
* using [[Geo Plugin]]s at project creation;
* using the [[Geo Data Wizard]] while running an editing [[session]] of your project.
 
==The {{software}}'s WFS endpoint==
[[File:WFS_endpoint_copy_url_neighborhoods.jpg|thumb|right|Obtain the URL for the WFS Endpoint of Neighborhoods by clicking on this button in the Export Panel.]]


The geographical features in [[project]]s can also be accessed via WFS endpoints. When exporting any geographical vector data, one of the options is to copy the session's WFS url. This url can be used in any GIS application which supports WFS.


It is also possible to provide another WFS. This WFS must conform to the following requirement before it can be loaded properly into the Engine:
All Tygron WFS options inherit from a single endpoint URL:
* The WFS must have either GML3 or GeoJSON as output format.  
{{code|<nowiki>https://engine.tygron.com/api/session/wfs</nowiki>}}
This endpoint exposes all available geographical data as individual layers. Each type of feature also has its own endpoint, which is accessible via each appropriate data type's export function. Accessing those endpoints directly may also expose a number of sub-layers, providing some filtering inherent to that type of data.


This buildings WFS endpoint provides a general layer containing all buildings and a set of [[category]] specific layers:
{{code|<nowiki>https://engine.tygron.com/api/session/wfs/buildings</nowiki>}}
WFS Endpoint for educational buildings:
{{code|<nowiki>https://engine.tygron.com/api/session/wfs/buildings-education</nowiki>}}
WFS Endpoint for education buildings having the attribute PRIMARY_SCHOOL:
{{code|<nowiki>https://engine.tygron.com/api/session/wfs/buildings-education-primary_school</nowiki>}}


The WFS can be loaded in the Engine by using the [[Geo Data Wizard]]. Choose the second option: "Loading data from a Feature Service".
In the next step, you will be asked to provide a name and the URL for the WFS. If the WFS is published through ArcGIS server (Arcgis is then part of the URL), choose ESRI_JSON as output type, otherwise choose WFS_JSON.


===Transaction support===
Additionally, if you have a GIS application with support for WFS transactions (WFS-t), you can also modify the accessed features in the GIS application and publish them back to the {{software}}. The affected features will then be modified in the project as well. Data can only be modified in this way if the resulting data would be valid. I.e. constructions are not allowed to overlap.


{{editor steps|title=Insert a WFS into the Engine|Choose a name for the WFS|Provinde the URL of the WFS (the GetCapabilities part can be omitted)|If the WFS is published through ArcGIS server, choose ESRI_JSON, otherwise choose WFS_JSON}}
{{article end
|howtos=
{{collapsible_list
|
* [[How to add a WFS link to your project]]
* [[How to edit a WFS link in your project]]
* [[How to remove a WFS link from your project]]
|
* [[How to access your project's WFS in QGIS]]
* [[How to access your project's WFS in ArcMap]]
* [[How to access your project's WFS in ArcGIS Pro]]
* [[How to edit your project data via WFS]]
* [[How to import data from a WFS]]
|
* [[How to modify your project's WFS url to filter on attributes]]
* [[How to modify your project's WFS url to expose all function values]]
* [[How to modify your project's WFS url to allow transactions to overwrite conflicting data]]
}}
|notes=
It is currently not possible to add the {{Software}} WFS to a Map in ArcGIS Online. This is because token-based authentication is not yet supported in ArcGIS Online. See for more information the documentation of ArcGIS Online about this topic: https://doc.arcgis.com/en/arcgis-online/reference/ogc.htm#ESRI_SECTION1_136F31FA3EFC4B0A875D4E590CE59550
|seealso=
* [[Geo Data Wizard]]
* [[Source]]s
* [[Geo Plugin]]s
}}
{{GeoDataOverview}}
[[Category:WFS]]

Latest revision as of 08:55, 15 July 2024

Identifying importable BAG features for a project area using the Geo Data Wizard.

A Web Feature Service, in short WFS, is an OGC standard in where data is published and can be downloaded in (geo) data formats specified by the service.

Spatial data can be obtained by querying the service with additional parameters, specifying the request, version, layer and option bounding box, data format and coordinate system. Generally these requests can be performed using a browser or GET requests, on a WFS endpoint and with the additional parameters stated as query parameters.

Data provided by these requests can be visualized by a GIS (Geographical Information System) software such as the Tygron Platform, QGIS, ArcGIS Pro and ArcGIS Online.

One of the advantages of a WFS is that the data is accessible on the internet, so you can always access it (if there is internet) and you don’t have to carry files with you anymore. Also sharing data is more easily, since you just have to provide the WFS URL.

WFS sources used in the Tygron Platform

BAG Source present in a project.

Each project created in the Tygron Platform has several default sources that store references to public Web Feature Services. When a Project is created for the Netherlands, some of these Web Feature Services are used to populate a project with Buildings, Terrains, Neighborhoods etc. These are:

  • BAG: the base registration for Addresses and Buildings in the Netherlands.
  • BRP: Gewaspercelen, a Dutch dataset containing the type of crops.
  • CBS Buurten: CBS Wijk en Buurtkaart; a Dutch dataset from the CBS containing the geometries of neighborhoods in the Netherlands and statistical data about these neighborhoods.
  • FGR: Fysisch geografische regio's; a Dutch dataset containing the types of land.

It is also possible to add new Web Feature Service links to your project, as Sources, and use these to obtain vector data to add to your project:

The Tygron Platform's WFS endpoint

Obtain the URL for the WFS Endpoint of Neighborhoods by clicking on this button in the Export Panel.

The geographical features in projects can also be accessed via WFS endpoints. When exporting any geographical vector data, one of the options is to copy the session's WFS url. This url can be used in any GIS application which supports WFS.

All Tygron WFS options inherit from a single endpoint URL:

https://engine.tygron.com/api/session/wfs

This endpoint exposes all available geographical data as individual layers. Each type of feature also has its own endpoint, which is accessible via each appropriate data type's export function. Accessing those endpoints directly may also expose a number of sub-layers, providing some filtering inherent to that type of data.

This buildings WFS endpoint provides a general layer containing all buildings and a set of category specific layers:

https://engine.tygron.com/api/session/wfs/buildings

WFS Endpoint for educational buildings:

https://engine.tygron.com/api/session/wfs/buildings-education

WFS Endpoint for education buildings having the attribute PRIMARY_SCHOOL:

https://engine.tygron.com/api/session/wfs/buildings-education-primary_school


Transaction support

Additionally, if you have a GIS application with support for WFS transactions (WFS-t), you can also modify the accessed features in the GIS application and publish them back to the Tygron Platform. The affected features will then be modified in the project as well. Data can only be modified in this way if the resulting data would be valid. I.e. constructions are not allowed to overlap.