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: Property. URL
- Optional
dateModified : Last update timestamp of this entity.
- Attribute type: Property. DateTime
- Read-Only. Automatically generated.
dateCreated : Entity's creation timestamp.
- Attribute type: Property. DateTime
- Read-Only. Automatically generated.
name : Name given to the weather forecast location.
- Normative References: https://schema.org/name
- Optional
location : Location of the weather observation represented by a GeoJSON geometry.
- Attribute type: Property. geo:json.
- Normative References: https://tools.ietf.org/html/rfc7946
- Mandatory if address is not defined.
address : Civic address of the weather forecast.
- Normative References: https://schema.org/address
- Mandatory if location is not present.
dateRetrieved : The date and time the forecast was retrieved in ISO8601 UTC format.
- Attribute type: Property. DateTime.
- Mandatory
dateIssued : The date and time the forecast was issued by the meteorological bureau in ISO8601 UTC format.
- Attribute type: Property. DateTime.
- Mandatory
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: Property. Text
- Mandatory
validFrom : Validity period start date and time.
- Attribute type: Property. DateTime.
- Optional
validTo : Validity period end date and time.
- Attribute type: Property. DateTime.
- Optional
source : A sequence of characters giving the source of the entity data.
- Attribute type: Property. Text or URL
- Optional
refPointOfInterest : A reference to a point of interest associated to this forecast.
- Attribute type: Relationship. Reference to an entity of type PointOfInterest
- Optional
weatherType : The forecasted weather type.
- See WeatherObserved.weatherType for description and allowed values.
- Optional
visibility : Visibility forecasted.
- See WeatherObserved.visibility for description and allowed values.
- Optional
temperature : Air's temperature forecasted.
- See WeatherObserved.temperature for description and units.
- Optional
feelsLikeTemperature : Feels like temperature forecasted.
- Attribute type: Property. Number
- Default unit: Degrees centigrades.
- Optional
relativeHumidity : Air's relative humidity forecasted (percentage, expressed in parts per one).
- See WeatherObserved.relativeHumidity for description and units.
- Optional
precipitationProbability : The probability of precipitation, expressed as a number between 0 ≤ precipitationProbability ≤ 1.
- Attribute type: Property. Number
- Optional
windDirection : Wind direction forecasted
- See WeatherObserved.windDirection for description and units.
- Optional
windSpeed : Wind speed forecasted.
- See WeatherObserved.windSpeed for description and units.
- Optional
dayMinimum : Minimum values forecasted for the reported period.
- Attribute type: Property. 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: Property. 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.
- Normative references: http://www.who.int/uv/intersunprogramme/activities/uv_index/en/
- Attribute type: Property. Number
- Optional

Note: JSON Schemas are intended to capture the data type and associated constraints of the different Attributes, regardless their final representation format in NGSI(v2, LD).

Examples

Normalized Example

Normalized NGSI response

{
    "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"
    },
    "relativeHumidity": {
        "value": 0.85
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "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",
    "windSpeed": 0
}

LD Example

Sample uses the NGSI-LD representation

{
    "id": "urn:ngsi-ld:WeatherForecast:Spain-WeatherForecast-46005_2016-12-01T18:00:00_2016-12-02T00:00:00",
    "type": "WeatherForecast",
    "dayMinimum": {
        "type": "Property",
        "value": {
            "feelsLikeTemperature": 11,
            "temperature": 11,
            "relativeHumidity": 0.7
        }
    },
    "feelsLikeTemperature": {
        "type": "Property",
        "value": 12
    },
    "dataProvider": {
        "type": "Property",
        "value": "TEF"
    },
    "temperature": {
        "type": "Property",
        "value": 12
    },
    "validTo": {
        "type": "Property",
        "value": {
            "@type": "DateTime",
            "@value": "2016-12-01T23:00:00.00Z"
        }
    },
    "weatherType": {
        "type": "Property",
        "value": "overcast"
    },
    "precipitationProbability": {
        "type": "Property",
        "value": 0.15
    },
    "dayMaximum": {
        "type": "Property",
        "value": {
            "feelsLikeTemperature": 15,
            "temperature": 15,
            "relativeHumidity": 0.9
        }
    },
    "source": {
        "type": "Property",
        "value": "http://www.aemet.es/xml/municipios/localidad_46250.xml"
    },
    "windSpeed": {
        "type": "Property",
        "value": 0
    },
    "validity": {
        "type": "Property",
        "value": "2016-12-01T18:00:00+01:00/2016-12-02T00:00:00+01:00"
    },
    "dateIssued": {
        "type": "Property",
        "value": {
            "@type": "DateTime",
            "@value": "2016-12-01T10:40:01.00Z"
        }
    },
    "address": {
        "type": "Property",
        "value": {
            "addressCountry": "Spain",
            "postalCode": "46005",
            "addressLocality": "Valencia",
            "type": "PostalAddress"
        }
    },
    "dateRetrieved": {
        "type": "Property",
        "value": {
            "@type": "DateTime",
            "@value": "2016-12-01T12:57:24.00Z"
        }
    },
    "validFrom": {
        "type": "Property",
        "value": {
            "@type": "DateTime",
            "@value": "2016-12-01T17:00:00.00Z"
        }
    },
    "relativeHumidity": {
        "type": "Property",
        "value": 0.85
    },
    "@context": [
        "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld",
        "https://schema.lab.fiware.org/ld/context"
    ]
}

Public instance

You can read about public instance offering information about weather forecast here.