Get WFS available layer information
emodnet_get_layer_info(wfs, layers) emodnet_get_wfs_info(wfs = NULL, service = NULL, service_version = NULL) emodnet_get_all_wfs_info()
emodnet_get_layer_info(wfs, layers) emodnet_get_wfs_info(wfs = NULL, service = NULL, service_version = NULL) emodnet_get_all_wfs_info()
wfs |
A |
layers |
a character vector of layer names. To get info on layers,
including
|
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
To minimize the number of requests sent to webservices,
these functions use memoise
to cache results inside the active R session.
To clear the cache, re-start R or
run memoise::forget(emodnet_get_wfs_info)
/
memoise::forget(emodnet_get_layer_info)
.
a tibble containing metadata on each layer available from the service.
emodnet_get_layer_info()
: Get metadata for specific layers. Requires a
wfs
object as input.
emodnet_get_wfs_info()
: Get info on all layers from
an EMODnet WFS service.
emodnet_get_all_wfs_info()
: Get metadata on all layers and all available
services from server.
emodnet_get_wfs_info(service = "bathymetry") # Query a wfs object wfs_bio <- emodnet_init_wfs_client("biology") emodnet_get_wfs_info(wfs_bio) # Get info for specific layers from wfs object layers <- c("mediseh_zostera_m_pnt", "mediseh_posidonia_nodata") emodnet_get_layer_info(wfs = wfs_bio, layers = layers)
emodnet_get_wfs_info(service = "bathymetry") # Query a wfs object wfs_bio <- emodnet_init_wfs_client("biology") emodnet_get_wfs_info(wfs_bio) # Get info for specific layers from wfs object layers <- c("mediseh_zostera_m_pnt", "mediseh_posidonia_nodata") emodnet_get_layer_info(wfs = wfs_bio, layers = layers)
Performs an WFS getFeature request for layers from a wfs
object or
specified EMODnet Service. Filtering
of layer features can also be handled via ECQL language filters.
emodnet_get_layers( wfs = NULL, service = NULL, service_version = NULL, layers, crs = NULL, cql_filter = NULL, simplify = FALSE, reduce_layers = deprecated(), ... )
emodnet_get_layers( wfs = NULL, service = NULL, service_version = NULL, layers, crs = NULL, cql_filter = NULL, simplify = FALSE, reduce_layers = deprecated(), ... )
wfs |
A |
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
layers |
a character vector of layer names. To get info on layers,
including
|
crs |
integer. EPSG code for the output crs. If |
cql_filter |
character. Features returned can be filtered using valid Extended Common Query Language (ECQL) filtering statements (https://docs.geoserver.org/stable/en/user/filter/ecql_reference.html). Should be one of:
|
simplify |
whether to reduce output layers to a single |
reduce_layers |
|
... |
additional vendor parameter arguments passed to
|
If simplify = FALSE
(default), a list of sf
objects, one element for each layer. Any layers for which download was
unsuccessful will be NULL. If simplify = TRUE
, all layers are
reduced (if possible: if all
column names are the same) to a single sf
containing data for all layers.
NULL
layers are ignored. simplify = TRUE
can also be used to return
an sf
out of a single layer request instead of a list of length 1.
If a layer is really big (like "abiotic_observations"
of the
"biology_occurrence_data"
service),
you might consider a combination of these ideas:
using outputFormat = "CSV"
;
filtering using cql_filters
or
bounding boxes
(possibly splitting the area of interests into several requests);
Using EMODnet's download toolbox.
# Layers as character vector emodnet_get_layers( service = "biology", layers = c("mediseh_zostera_m_pnt", "mediseh_posidonia_nodata") ) # Usage of cql_filter emodnet_get_layers( service = "biology", layers = "mediseh_zostera_m_pnt", cql_filter = "country = 'Francia'" ) # Usage of vendor parameter emodnet_get_layers( service = "biology", layers = "mediseh_zostera_m_pnt", count = 1 ) # Usage of csv output data <- emodnet_get_layers( service = "biology_occurrence_data", layers = "abiotic_observations", outputFormat = "CSV" ) str(data[["abiotic_observations"]])
# Layers as character vector emodnet_get_layers( service = "biology", layers = c("mediseh_zostera_m_pnt", "mediseh_posidonia_nodata") ) # Usage of cql_filter emodnet_get_layers( service = "biology", layers = "mediseh_zostera_m_pnt", cql_filter = "country = 'Francia'" ) # Usage of vendor parameter emodnet_get_layers( service = "biology", layers = "mediseh_zostera_m_pnt", count = 1 ) # Usage of csv output data <- emodnet_get_layers( service = "biology_occurrence_data", layers = "abiotic_observations", outputFormat = "CSV" ) str(data[["abiotic_observations"]])
Initialise an EMODnet WFS client
emodnet_init_wfs_client(service, service_version = NULL, logger = NULL)
emodnet_init_wfs_client(service, service_version = NULL, logger = NULL)
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
logger |
the logger. Either |
An ows4R::WFSClient
R6 object with methods for interfacing an
OGC Web Feature Service.
WFSClient
in package ows4R
.
wfs <- emodnet_init_wfs_client(service = "bathymetry")
wfs <- emodnet_init_wfs_client(service = "bathymetry")
Available EMODnet Web Feature Services
emodnet_wfs()
emodnet_wfs()
emodnet_wfs
EMODnet disciplinary themes - bathymetry, biology, chemistry, geology, human activities, physics and seabed habitats
Name of the specific service. Use in emodnet_init_wfs_client.
Web Feature Service (WFS) URL endpoint for accessing the service.
Tibble of available EMODnet Web Feature Services
emodnet_wfs()
emodnet_wfs()
Get layer attribute description
layer_attribute_descriptions( wfs = NULL, service = NULL, service_version = NULL, layer )
layer_attribute_descriptions( wfs = NULL, service = NULL, service_version = NULL, layer )
wfs |
A |
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
layer |
character sting of layer name. To get info on layers, including
|
data.frame containing layer attribute descriptions (metadata).
Attributes metadata:
layer_attribute_inspect()
,
layer_attributes_get_names()
,
layer_attributes_summarise()
,
layer_attributes_tbl()
layer_attribute_descriptions( service = "biology", layer = "mediseh_zostera_m_pnt" )
layer_attribute_descriptions( service = "biology", layer = "mediseh_zostera_m_pnt" )
Inspect layer attributes
layer_attribute_inspect( wfs = NULL, service = NULL, service_version = NULL, layer, attribute )
layer_attribute_inspect( wfs = NULL, service = NULL, service_version = NULL, layer, attribute )
wfs |
A |
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
layer |
character sting of layer name. To get info on layers, including
|
attribute |
character string, name of layer attribute (variable). Use
|
Detailed summary of individual attribute (variable). Particularly useful for inspecting factor or character variable levels or unique values.
Attributes metadata:
layer_attribute_descriptions()
,
layer_attributes_get_names()
,
layer_attributes_summarise()
,
layer_attributes_tbl()
wfs <- emodnet_init_wfs_client(service = "biology") layer_attributes_get_names(wfs, layer = "mediseh_zostera_m_pnt") layer_attribute_inspect( wfs, layer = "mediseh_zostera_m_pnt", attribute = "country" )
wfs <- emodnet_init_wfs_client(service = "biology") layer_attributes_get_names(wfs, layer = "mediseh_zostera_m_pnt") layer_attribute_inspect( wfs, layer = "mediseh_zostera_m_pnt", attribute = "country" )
Names of variables (attributes) available from a dataset (layer) in a data source (service).
layer_attributes_get_names( wfs = NULL, service = NULL, service_version = NULL, layer )
layer_attributes_get_names( wfs = NULL, service = NULL, service_version = NULL, layer )
wfs |
A |
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
layer |
character sting of layer name. To get info on layers, including
|
character vector of layer attribute (variable) names.
Attributes metadata:
layer_attribute_descriptions()
,
layer_attribute_inspect()
,
layer_attributes_summarise()
,
layer_attributes_tbl()
layer_attributes_get_names( service = "biology", layer = "mediseh_zostera_m_pnt" )
layer_attributes_get_names( service = "biology", layer = "mediseh_zostera_m_pnt" )
Get summaries of layer attributes (variables)
layer_attributes_summarise( wfs = NULL, service = NULL, service_version = NULL, layer )
layer_attributes_summarise( wfs = NULL, service = NULL, service_version = NULL, layer )
wfs |
A |
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
layer |
character sting of layer name. To get info on layers, including
|
output of summary()
on the attributes (variables) in a given layer
for a given service.
Attributes metadata:
layer_attribute_descriptions()
,
layer_attribute_inspect()
,
layer_attributes_get_names()
,
layer_attributes_tbl()
layer_attributes_summarise( service = "biology", layer = "mediseh_zostera_m_pnt" )
layer_attributes_summarise( service = "biology", layer = "mediseh_zostera_m_pnt" )
Get layer attribute values tibble
layer_attributes_tbl(wfs = NULL, service = NULL, service_version = NULL, layer)
layer_attributes_tbl(wfs = NULL, service = NULL, service_version = NULL, layer)
wfs |
A |
service |
the EMODnet OGC WFS service name.
For available services, see |
service_version |
|
layer |
character sting of layer name. To get info on layers, including
|
Request excluding spatial information can be significantly faster. Can be useful for inspecting attribute values and constructing feature filters for more targeted and faster layer download.
tibble of layer attribute (variable) values with geometry column removed.
Attributes metadata:
layer_attribute_descriptions()
,
layer_attribute_inspect()
,
layer_attributes_get_names()
,
layer_attributes_summarise()
layer_attributes_tbl(service = "biology", layer = "mediseh_zostera_m_pnt")
layer_attributes_tbl(service = "biology", layer = "mediseh_zostera_m_pnt")