Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
32 changes: 32 additions & 0 deletions workshop/content/docs/publishing/ogcapi-edr.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,38 @@ that there is a `parameter_names` key that describes EDR parameter names for the

Try visualizing the following EDR position query in a web browser: <http://localhost:5000/collections/icoads-sst/position?coords=POINT(174.7645%20-36.8509)>

## Client access

### QGIS

[QGIS](https://qgis.org/) supports OGC API - EDR via the [EDR plugin](https://plugins.qgis.org/plugins/edr_plugin/). You can install the plugin directly from the QGIS Plugin Hub, by going to `Plugins->Manage and Install Plugins` on the top level menu.

![](../assets/images/edr-plugin1.png){ width=100% }

You can access the plugin through an entry on the plugin menu.

![](../assets/images/edr-plugin2.png){ width=100% }

The first thing to setup is the server url. Use the url of the Landing Page here: `http://localhost:5000/`

!!! tip "You should also start by defining the folder where you would like the data fetched by the plugin to be downloaded"

![](../assets/images/edr-plugin3.png){ width=100% }

The combo box will be populated with all the collections available on that server. Select the EDR collection: `International Comprehensive Ocean-Atmosphere Data Set (ICOADS)`.

!!! tip "You may safely ignore the warnings displayed here"

![](../assets/images/edr-plugin4.png){ width=100% }

The data query combo box will be populated with the data query types available for this collection; in this case: position and cube. You may select the cube query and then click the button to set the spatial extent of that query. A new dialog will open, displaying multiple options to define the spatial extent. You may choose the `Draw on canvas`, to draw a rectangle in the map view extent.

![](../assets/images/edr-plugin5.png){ width=100% }

You can close this dialog and run the query. The plugin will fetch all the data available that fits into this query and display it as a layer group.

![](../assets/images/edr-plugin6.png){ width=100% }

### OWSLib - Advanced

[OWSLib](https://owslib.readthedocs.io) is a Python library to interact with OGC Web Services and supports a number of OGC APIs including OGC API - Environmental Data Retrieval.
Expand Down
32 changes: 32 additions & 0 deletions workshop/content/docs/publishing/ogcapi-edr.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,38 @@ Guarde a configuração e reinicie o Docker Compose. Navegue para <http://localh
À primeira vista, a coleção `icoads-sst` aparece como uma coleção normal OGC API - Coverages. Olhe um pouco mais de perto para a descrição da coleção, e note
que há uma chave 'parameter_names' que descreve os nomes dos parâmetros EDR para as consultas da coleção.

## Acesso do lado do cliente

### QGIS

O [QGIS](https://qgis.org/) dá suporte à OGC API - EDR através do [plugin EDR](https://plugins.qgis.org/plugins/edr_plugin/). Pode instalar-lo directamente através do Hub de plugins do QGIS, indo a `Plugins->Gerir e instalar Plugins` no menu de topo.

![](../assets/images/edr-plugin1.png){ width=100% }

Pode aceder ao plugin através de uma entrada no menu de plugins.

![](../assets/images/edr-plugin2.png){ width=100% }

A primeira coisa a fazer é configurar o url do servidor. Use aqui o url da Landing Page: `http://localhost:5000/`

!!! tip "Também deveria comecar por definir a directoria onde gostaria de guardar os dados descarregados pelo plugin"

![](../assets/images/edr-plugin3.png){ width=100% }

A combo box será populada com todas as coleções disponiveis naquele servidor. Seleccione a coleção EDR: `International Comprehensive Ocean-Atmosphere Data Set (ICOADS)`.

!!! tip "Pode ignorar os avisos mostrados aqui!"

![](../assets/images/edr-plugin4.png){ width=100% }

A combo box de query de dados será populada com os tipos de query de dados disponiveis para esta coleção, neste caso: posição e cubo. Pode seleccionar a query do tipo cubo e carregar no botão que permite definir a extensão espacial da query. Um novo diálogo irá abrir, mostrando as diferentes opções para definir a extensão espacial. Pode escolher `Desenhar no canvas`, para desenhar um rectângulo no extent da map view.

![](../assets/images/edr-plugin5.png){ width=100% }

Pode fechar este dialogo e executar a query. O plugin irá descarregar todos os dados disponiveis que se encaixam nesta query e mostrar-los como um grupo de layers.

![](../assets/images/edr-plugin6.png){ width=100% }

### OWSLib - Avançado

[OWSLib](https://owslib.readthedocs.io) é uma biblioteca Python para interagir com Serviços Web OGC e suporta várias OGC APIs incluindo OGC API - Environmental Data Retrieval.
Expand Down
56 changes: 28 additions & 28 deletions workshop/exercises/pygeoapi.config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -385,34 +385,34 @@ resources:
## END - EXERCISE 6 - Metadata

## START EXERCISE 7 - Environmental data via OGC API - Environmental Data Retrieval
# icoads-sst:
# type: collection
# title: International Comprehensive Ocean-Atmosphere Data Set (ICOADS)
# description: International Comprehensive Ocean-Atmosphere Data Set (ICOADS)
# keywords:
# - icoads
# - sst
# - air temperature
# extents:
# spatial:
# bbox: [-180,-90,180,90]
# crs: http://www.opengis.net/def/crs/OGC/1.3/CRS84
# temporal:
# begin: 2000-01-16T06:00:00Z
# end: 2000-12-16T06:00:00Z
# links:
# - type: text/html
# rel: canonical
# title: information
# href: https://psl.noaa.gov/data/gridded/data.coads.1deg.html
# hreflang: en-US
# providers:
# - type: edr
# name: xarray-edr
# data: /data/coads_sst.nc
# format:
# name: NetCDF
# mimetype: application/x-netcdf
icoads-sst:
type: collection
title: International Comprehensive Ocean-Atmosphere Data Set (ICOADS)
description: International Comprehensive Ocean-Atmosphere Data Set (ICOADS)
keywords:
- icoads
- sst
- air temperature
extents:
spatial:
bbox: [-180,-90,180,90]
crs: http://www.opengis.net/def/crs/OGC/1.3/CRS84
temporal:
begin: 2000-01-16T06:00:00Z
end: 2000-12-16T06:00:00Z
links:
- type: text/html
rel: canonical
title: information
href: https://psl.noaa.gov/data/gridded/data.coads.1deg.html
hreflang: en-US
providers:
- type: edr
name: xarray-edr
data: /data/coads_sst.nc
format:
name: NetCDF
mimetype: application/x-netcdf
## END EXERCISE 7 - Environmental data via OGC API - Environmental Data Retrieval

hello-world:
Expand Down