WFS: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(49 intermediate revisions by 4 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, edit or remove a WFS into/from the {{software}}}}
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 {{software}}==
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 {{software}}, 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 provide your own WFS. This WFS must conform to the following requirement before it can be loaded properly into the {{software}}:
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:
* The WFS must have either GML3 or GeoJSON as output format.  
* using [[Geo Plugin]]s at project creation;
* using the [[Geo Data Wizard]] while running an editing [[session]] of your project.


The WFS can be loaded in the {{software}} by using the [[Geo Data Wizard]]. Choose the second option: "Loading data from a Feature Service".
==The {{software}}'s WFS endpoint==
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.
[[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.


{{editor steps|title=Insert a WFS into the {{software}}|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}}
All Tygron WFS options inherit from a single endpoint URL:
{{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>}}


==How to edit or remove a WFS URL==
[[File:Edit_url_source.JPG|right|200px]]
{{Editor steps|title=edit a WFS Connection|Select in the editor Current situation|Hover over 'Geo Import' from the ribbon bar| Select 'Show Project Sources'|Select the desired connection you wish to edit|In the panel on the right, edit the name, URL, Uploader and/or description}}
<br clear=all>


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


[[File:Remove_source.JPG|right|200px]]
{{article end
{{Editor steps|title=remove a WFS Connection|Select in the editor Current situation|Hover over 'Geo Import' from the ribbon bar| Select 'Show Project Sources'|Select the desired connection you wish to remove|Click on the button 'Remove' at the bottom left corner}}
|howtos=
<br>
{{collapsible_list
{{Template:GeoDataOverview}}
|
* [[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.