This version (0.1) is currently in beta and should not yet be used in production. [Work in progress]
 

NAME

Volcanicashforecast - Norwegian national volcanic ash products including forecast

DESCRIPTION

This service offers links to the Norwegian national ash products for aviation in case of volcanic ash in the atmosphere near to Norway. The products include volcanic ash forecast images, satellite images and a report with further information. Results of this service can be seen on https://ippc.no or https://volcanicashtest.met.no during an volcanic eruption in Northern Europe.

METHODS

/

The main request for volcanic ash product information.

Parameters

reftime

The reference time of the product, or the latest one if not specified.

Sample request URLs

  https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/ (latest)
  https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/?reftime=2019-12-10T21:00:00Z (probably won't work unless there is a eruption)

Return structure

The return structure is defined as a list of the #/definitions/AshModel in the Swagger Schema. An example:

    {
      "layergroups": [
        {
          "layers": [
            {
              "type": "WMS",
              "base_url": "https://thredds.met.no/thredds/wms/data/VolcanicAsh/PublicResults/ExtraResults/2019-03-22-VOLCICE_Hekla/eemep_hour_20190322T153201.nc?LAYERS=MAX6h_ASH_fl000-200&TRANSPARENT=true&LOGSCALE=false&BELOWMINCOLOR=transparent&ABOVEMAXCOLOR=extend",
              "name": "Model_EEMEP",
              "timesteps": [
                {
                  "time": "2019-03-22T14:00:00Z",
                  "url": "https://thredds.met.no/thredds/wms/data/VolcanicAsh/PublicResults/ExtraResults/2019-03-22-VOLCICE_Hekla/eemep_hour_20190322T153201.nc?LAYERS=MAX6h_ASH_fl000-200&TRANSPARENT=true&LOGSCALE=false&BELOWMINCOLOR=transparent&ABOVEMAXCOLOR=extend&TIME=2019-03-22T14:00:00Z"
                }
              ]
            },
            {
              "type": "WMS",
              "base_url": "https://thredds.met.no/thredds/wms/data/VolcanicAsh/PublicResults/ExtraResults/2019-03-22-VOLCICE_Hekla/FLEXPART_6hmax_20190322T153405.nc?LAYERS=MAX6h_ASH_fl000-200&TRANSPARENT=true&LOGSCALE=false&BELOWMINCOLOR=transparent&ABOVEMAXCOLOR=extend",
              "name": "Model_FLEXP",
              "timesteps": [
                {
                  "time": "2019-03-22T14:00:00Z",
                  "url": "https://thredds.met.no/thredds/wms/data/VolcanicAsh/PublicResults/ExtraResults/2019-03-22-VOLCICE_Hekla/FLEXPART_6hmax_20190322T153405.nc?LAYERS=MAX6h_ASH_fl000-200&TRANSPARENT=true&LOGSCALE=false&BELOWMINCOLOR=transparent&ABOVEMAXCOLOR=extend&TIME=2019-03-22T14:00:00Z"
                },
              ]
            },
            {
              "type": "KML",
              "name": "Model_VAAC",
              "timesteps": [
                {
                  "time": "2019-03-22T16:00:00Z",
                  "url": "./resources?name=VAAC_kml/vaac_london_IT20190322T1535/20190322T1600Z_000-200.kml"
                },
              ]
            }
          ],
          "name": "FL000-200"
        }
      ],
      "meta": {
        "report_url": "./resources?name=Reports/report_20190322T1600.pdf",
        "description": "VOLCICE Hekla Exercise 2019-03-22",
        "type": "Exercise",
        "reftime": "2019-03-22T16:00:00Z",
        "timesteps": [
          {
            "time": "2019-03-22T14:00:00Z"
          }
        ],
        "latlonbox": {
          "south": 50,
          "east": 20,
          "north": 75,
          "west": -30
        }
      }
    }

/reftimes

List of reference times with products. Products might both include real ash eruptions as well as exercises. Takes no parameters.

Sample request URLs

  https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/reftimes

Return structure

The return structure is defined as a list of the #/definitions/RefTimeModel in the [Schema]. An example:

    {
      "reftimes": [
        "2019-03-22T16:00:00Z",
        "2019-02-28T11:00:00Z"
      ]
    }

/resources

Files to download. If no parameters, returns a list of available resources.

Parameters

name

Name of the resource to be downloaded. Links to these resources are usually given in the main request.

Sample request URLs:

    https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/resources
    https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/resources?name=Reports/report_20181019_02.pdf (will this work indefinitely?)

Schema

The schema for the request-parameters for this product is available from

  https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/swagger.json .

Restrictions

The availability and content of this product may change without further notice.

CHANGELOG

All changes are available as an RSS feed at the following URL: https://aa025kn2jhfvzrxns.api.met.no/weatherapi/volcanicashforecast/0.1/changelog

Version 0.1: 2019-03-27

First prototype