Introduction

The Weather data API is for discovery of and usage of weather datasources, providing input data to DSS, both measured/calculated data from the current growing season and weather forecasts. The service provides sufficient information for a client to be able to connect to and get information from any weather data source. The API is primarily for developers who need to develop scripts or applications that access MaDiPHS' historical weather and climate data.

There are three main components of the service:

The platform's standard weather data format

The format is described as a Json schema. The schema and the validation service for weather data are part of the MetaDataService. The MetaDataService also provides lists of the weather parameters and QC codes.

A catalogue of weather data sources available to the platform

The catalogue of weather data sources is a searchable list of weather data providers available to the platform. Each data source is described both in human readable format and through meta data. The latter enables a client to generate a weather data request to send to the data source. The catalogue is available from the WeatherDataSourceService.

Adapters for weather data sources to get weather data in the standard format

Some weather data sources may agree to deliver their weather data in the platform’s format directly. For the data sources that do not, adapters have to be programmed. The adapter's role is to download the data from the specified source and transform it into the platform's format. If the platform is using an adapter to download the weather data from a data source, the adapter's endpoint is specified in the weather data source catalogue. The adapters are available from the WeatherAdapterService.

Next