smartmet-plugin-meta

April 3, 2026 · View on GitHub

Part of SmartMet Server. See the SmartMet Server documentation for a full overview of the ecosystem.

Introduction

The purpose of the meta plugin is to provide access to the meta data of observations. We can specify the language in which we would like to have the the metadata in the request. Currently the plugin supports both Finnish (fin) and English (eng) languages.

For the meta plugin the following access parameters are available:

  • qualityCode
  • observableProperty

Example: Quality code request

There are 10 quality codes which are the following:

quality codedescription
0Unknown quality
1Good quality (automatically checked)
2Good quality (manually checked)
3Accepted quality (automatically checked
4Accepted quality (manually checked)
5Missing value in database
6Not accepted quality (automatically checked)
7Not accepted quality (manually checked)
8Erroneous value (automatically checked
9Erroneous value (manually checked

Here is an example showing the quality code request.


http://data.fmi.fi/meta?qualitycode=0&language=eng&fmi-apikey=YOUR-FMI-APIKEY&

The response to the meta data request for the quality code 0 is given below.

<Category xsi:schemaLocation="http://www.opengis.net/swe/2.0 http://schemas.opengis.net/sweCommon/2.0/swe.xsd">    
  -<quality>
   -<Category id="qc-0">
     <label>Unknown quality</label>
     -<description>
          Value is not quality controlled and it may be erroneous. This quality code is typically given for observations that are not checked in any way. For example foreign synops and road weather observations.
     </description>
     <value>0</value>
   </Category>
  </quality>
</Category>

Example: observableProperty

In the example below shows the metadata request for the observableProperty, "Air temperature".


http://data.fmi.fi/fmi-apikey/YOUR-FMI-APIKEY/meta?observableProperty=observation¶m=TA&language=eng

The response to the meta data request for the observableProperty, "Air temperature" is given below.

<ObservableProperty gml:id="ta" xsi:schemaLocation="http://inspire.ec.europa.eu/schemas/omop/2.9 http://inspire.ec.europa.eu/draft-schemas/omop/2.9
/ObservableProperties.xsd">
   <label>Air temperature</label>
   <basePhenomenon>Temperature</basePhenomenon>
   <uom uom="degC"/>
   -<statisticalMeasure>
      -<StatisticalMeasure gml:id="stat-avg-PT1M-ta---">
           <statisticalFunction>avg</statisticalFunction>
           <aggregationTimePeriod>PT1M</aggregationTimePeriod>
       </StatisticalMeasure>
  </statisticalMeasure>
</ObservableProperty>