Weather Forecast

Description

This entity contains a harmonised description of a Weather Forecast. This entity is primarily associated with the vertical segments of the environment and agriculture but is applicable to many different applications.

This data model has been developed in cooperation with mobile operators and the GSMA.

You can see a description of weather forecast parameters provided by AEMET (in Spanish) here.

Data Model

A JSON Schema corresponding to this data model can be found here.

  • id : Unique identifier.

  • type : Entity type. It must be equal to WeatherForecast.

  • dataProvider : Specifies the URL to information about the provider of this information

  • Attribute type: URL
  • Optional

  • dateModified : Last update timestamp of this entity.

    • Attribute type: DateTime
    • Read-Only. Automatically generated.
  • dateCreated : Entity's creation timestamp.

    • Attribute type: DateTime
    • Read-Only. Automatically generated.
  • name : Name given to the weather forecast location.

  • location : Location of the weather observation represented by a GeoJSON geometry.

  • address : Civic address of the weather forecast.
  • dateRetrieved : The date and time the forecast was retrieved in ISO8601 UTC format.
  • dateIssued : The date and time the forecast was issued by the meteorological bureau in ISO8601 UTC format.
  • validity : Includes the validity period for this forecast as a ISO8601 time interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: validFrom, validTo. + Attribute type: Text + Mandatory
  • validFrom : Validity period start date and time.
  • validTo : Validity period end date and time.
  • source : A sequence of characters giving the source of the entity data.

    • Attribute type: Text or URL
    • Optional
  • refPointOfInterest : A reference to a point of interest associated to this forecast.

    • Attribute type: Reference to an entity of type PointOfInterest
    • Optional
  • weatherType : The forecasted weather type.
  • visibility : Visibility forecasted.

  • temperature : Air's temperature forecasted.

  • feelsLikeTemperature : Feels like temperature forecasted.

    • Attribute type: Number
    • Default unit: Degrees centigrades.
    • Optional
  • relativeHumidity : Air's relative humidity forecasted (percentage, expressed in parts per one).

  • precipitationProbability : The probability of precipitation, expressed as a number between 0 ≤ precipitationProbability ≤ 1.

    • Attribute type: Number
    • Optional
  • windDirection : Wind direction forecasted

  • windSpeed : Wind speed forecasted.

  • dayMinimum : Minimum values forecasted for the reported period.

    • Attribute type: StructuredValue
    • Subattributes:
      • temperature : Minimum temperature. Same semantics and units as WeatherForecast.temperature.
      • feelLikesTemperature. Minimum feels like temperature. Same semantics and units as WeatherForecast.feelsLikeTemperature.
      • relativeHumidity. Minimum relative humidity. Same semantics and units as WeatherForecast.relativeHumidity.
    • Optional
  • dayMaximum : Maximum values for the reported period.

    • Attribute type: StructuredValue
    • Subattributes:
      • temperature : Maximum temperature. See WeatherForecast.temperature for description and units.
      • feelLikesTemperature. Maximum feels like temperature. Same semantics and units as WeatherForecast.feelsLikeTemperature.
      • relativeHumidity. Maximum relative humidity. Same semantics and units as WeatherForecast.relativeHumidity.
  • uVIndexMax : The maximum UV index for the period, based on the World Health Organization's UV Index measure.

Note: JSON Schemas only capture the NGSI simplified representation, this means that to test the JSON schema examples with a FIWARE NGSI version 2 API implementation, you need to use the keyValues mode (options=keyValues).

Examples of use 1 (Normalized Format)

{
    "id": "Spain-WeatherForecast-46005_2016-12-01T18:00:00_2016-12-02T00:00:00",
    "type": "WeatherForecast",
    "dayMinimum": {
        "value": {
            "feelsLikeTemperature": 11,
            "temperature": 11,
            "relativeHumidity": 0.7
        }
    },
    "feelsLikeTemperature": {
        "value": 12
    },
    "dataProvider": {
        "value": "TEF"
    },
    "temperature": {
        "value": 12
    },
    "validTo": {
        "type": "DateTime",
        "value": "2016-12-01T23:00:00.00Z"
    },
    "weatherType": {
        "value": "overcast"
    },
    "precipitationProbability": {
        "value": 0.15
    },
    "dayMaximum": {
        "value": {
            "feelsLikeTemperature": 15,
            "temperature": 15,
            "relativeHumidity": 0.9
        }
    },
    "source": {
        "value": "http://www.aemet.es/xml/municipios/localidad_46250.xml"
    },
    "windSpeed": {
        "value": 0
    },
    "validity": {
        "value": "2016-12-01T18:00:00+01:00/2016-12-02T00:00:00+01:00"
    },
    "dateIssued": {
        "type": "DateTime",
        "value": "2016-12-01T10:40:01.00Z"
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressCountry": "Spain",
            "postalCode": "46005",
            "addressLocality": "Valencia"
        }
    },
    "dateRetrieved": {
        "type": "DateTime",
        "value": "2016-12-01T12:57:24.00Z"
    },
    "validFrom": {
        "type": "DateTime",
        "value": "2016-12-01T17:00:00.00Z"
    },
    "windDirection": {
        "value": null
    },
    "relativeHumidity": {
        "value": 0.85
    }
}

Examples of use 2 (?options=keyValues simplified representation for data consumers)

{
        "id": "Spain-WeatherForecast-46005_2016-12-01T18:00:00_2016-12-02T00:00:00",
        "type": "WeatherForecast",
        "address":
        {
            "addressCountry": "Spain",
            "postalCode": "46005",
            "addressLocality": "Valencia"
        },
        "dataProvider": "TEF",
        "dateIssued": "2016-12-01T10:40:01.00Z",
        "dateRetrieved": "2016-12-01T12:57:24.00Z",
        "dayMaximum":
        {
            "feelsLikeTemperature": 15,
            "temperature": 15,
            "relativeHumidity": 0.9
        },
        "dayMinimum":
        {
            "feelsLikeTemperature": 11,
            "temperature": 11,
            "relativeHumidity": 0.7
        },
        "feelsLikeTemperature": 12,
        "precipitationProbability": 0.15,
        "relativeHumidity": 0.85,
        "source": "http://www.aemet.es/xml/municipios/localidad_46250.xml",
        "temperature": 12,
        "validFrom": "2016-12-01T17:00:00.00Z",
        "validTo": "2016-12-01T23:00:00.00Z",
        "validity": "2016-12-01T18:00:00+01:00/2016-12-02T00:00:00+01:00",
        "weatherType": "overcast",
        "windDirection": null,
        "windSpeed": 0
    }

Use it with a real service

To get access to a public instance offering weather forecast data please have a look at the GSMA's API Directory.

The instance described here has been set up by the FIWARE Community.

Open Issues