Skip to content

Latest commit

 

History

History
116 lines (66 loc) · 3.09 KB

5-use-cases.adoc

File metadata and controls

116 lines (66 loc) · 3.09 KB
Raw

Use Case 1. Open Data Developer, Time Series

User searches for next days weather forecast to create a calendar subscription feed.

Actors

Developer who is experienced in web technologies but have no preliminary knowledge of geospatial APIs or environmental data usage.

Preconditions

  • Developer is familiar with at least OpenAPI3 and WFS3

  • Developer knows weather parameters, location and time range of interest

Process

  1. The developer gets familiar with API and its providing

  2. The developer searches the appropriate library and integrates it to the software

  3. The developer defines point and time range of interest

  4. The library takes care of requesting and retrieving the data

  5. The developer decorates the output to the software

Required Input Details

  • API address

  • Weather parameter(s) name

  • Coordinates of the location of interest

  • The time range of interest

Output Format

JSON containing time series of the requested parameter with minimal metadata (location, time, unit).

Related Requirements

  • Libraries to exist

Use Case 2. Open Data Developer, Single Time

User searches for next days weather forecast to create a calendar subscription feed.

Actors

Developer who is experienced in web technologies but have no preliminary knowledge of geospatial APIs or environmental data usage.

Preconditions

  • Developer is familiar with at least OpenAPI3 and WFS3

  • Developer knows weather parameters, location and time of interest

Process

  1. The developer gets familiar with API and its providing

  2. The developer searches the appropriate library and integrates it to the software

  3. The developer defines point and time of interest

  4. The library takes care of requesting and retrieving the data

  5. The developer decorates the output to the software

Required Input Details

  • API address

  • Weather parameter(s) name

  • Coordinates of the location of interest

  • Time of interest

Output Format

JSON containing values of the requested parameter with minimal metadata (location, time, unit).

Related Requirements

  • Libraries to exist

Use Case 3. Open Data Developer, Data Explorer

The user wants to get a sense of values in the data.

Actors

Developer who is experienced in web technologies but have no preliminary knowledge of geospatial APIs or environmental data usage.

Preconditions

  • Developer is familiar with at least OpenAPI3 and WFS3

  • Developer knows weather parameters, area of interest

  • Developer have QGIS or similar installed

Process

  1. The developer finds API endpoint

  2. The developer open QGIS desktop application

  3. The developer enters API endpoint and selects the dataset (collection) of interest

  4. QGIS show data values in 100 points spread regularly to the data area

  5. User may zoom in and out while getting always 100 points inside shown area

Required Input Details

  • API address

  • Collection name

  • Weather parameter(s) name

Output Format

API output is a 100 features which form a regular grid in the requested area. QGIS visualise the data to the user.

Related Requirements

  • QGIS OGC API - Features Core (WFS3) support