/

Weather/Ocean data and forecasts

Provides historic, current, and forecast weather data globally.


For more information, please read the block description.

Block type: DATA

Supported parameters

This blocks provides access to the Meteomatics REST-style API to retrieve historic, current, and forecast data globally. In this block, model data and observational data is available as time series in NetCDF format. Meteomatics provides a huge variety of climate variables and options, by default we provide temperatures (in Celsius [°C] unit, at 2 meters above the ground), accumulated precipitation (millimeters, every 5 minutes) and instantaneous wind speed (100 meter per second). For a specific variable, you can just add the name of it to the default variables list according to description provided by Meteomatics. For more information about other variables please refer to Meteomatics website For more information on supported filters, see query filter section.

  • bbox: The bounding box to use as an area of interest (AOI). Will return all scenes that intersect with this box. Use only bbox or intersects or contains.

  • intersects: A GeoJSON geometry to use as an AOI. Will return all scenes that intersect with this geometry. Use only bbox or intersects or contains.

  • time: A date range to filter scenes on. This range applies to the acquisition date/time of the scenes.

  • time_series: An array of date range filters as defined by time. If defined, the limit parameter applies to each date range individually and the time filter is ignored.

  • time_interval: A desired spacing in hours between the start and end point in time. By default, time_interval is set to 3 hours.

In this block we select the mix option provided by Meteomatics which combines different models and sources into an intelligent blend, such that the best data source is chosen for each time and location. The length of the forecasting period as well as the spatial resolution depends on the model from which the requested parameters originate.

The arcseconds resolution for retrieving the time series of a variable will be set based on the size of chosen AOI. In this way, hitting the limit of query point provided by meteomatics API will be avoided.

In order to be able to read NetCDF files, you can either use free applications like Panoply or using Ncview. Alternatively you can use the NetCDF conversion block to obtain a GeoTIFF.

It is recommended to select an AOI with the minimum size of 0.00001 square kilometers to avoid any job failures due to constraints from meteomatics API side.

Spatial resolution

The spatial data resolution provided by this block is dependant on the AOI size:

Example queries

Example query using bbox:

{
  "meteomatics:1": {
        "bbox": [
          13.342896,
          52.466887,
          13.478851,
          52.547131
        ],
        "time": "2019-12-01T00:00:00+00:00/2019-12-05T23:59:59+00:00",
        "variables": [
          "t_2m:C",
          "precip_5min:mm",
          "wind_speed_100m:ms"
        ],
        "time_interval": 3
  }
}

Output format

{
"type": "FeatureCollection",
"features": [
[
  {
        "type": "Feature",
        "bbox": [
          13.342896,
          52.466887,
          13.478851,
          52.547131
        ],
        "geometry": {
          "type": "Polygon",
          "coordinates": [
                [
                  [
                        13.478851,
                        52.466887
                  ],
                  [
                        13.478851,
                        52.547131
                  ],
                  [
                        13.342896,
                        52.547131
                  ],
                  [
                        13.342896,
                        52.466887
                  ],
                  [
                        13.478851,
                        52.466887
                  ]
                ]
          ]
        },
        "properties": {
          "model_type": "mix",
          "parameter_name": "t_2m_C",
          "up42.data_path": "87022219-95fc-47f1-b210-e3ca8a629ee8/t_2m_C.nc"
        }
  },
  {
        "type": "Feature",
        "bbox": [
          13.342896,
          52.466887,
          13.478851,
          52.547131
        ],
        "geometry": {
          "type": "Polygon",
          "coordinates": [
                [
                  [
                        13.478851,
                        52.466887
                  ],
                  [
                        13.478851,
                        52.547131
                  ],
                  [
                        13.342896,
                        52.547131
                  ],
                  [
                        13.342896,
                        52.466887
                  ],
                  [
                        13.478851,
                        52.466887
                  ]
                ]
          ]
        },
        "properties": {
          "model_type": "mix",
          "parameter_name": "precip_5min_mm",
          "up42.data.scene.netcdf": "87022219-95fc-47f1-b210-e3ca8a629ee8/precip_5min_mm.nc"
        }
  },
  {
        "type": "Feature",
        "bbox": [
          13.342896,
          52.466887,
          13.478851,
          52.547131
        ],
        "geometry": {
          "type": "Polygon",
          "coordinates": [
                [
                  [
                        13.478851,
                        52.466887
                  ],
                  [
                        13.478851,
                        52.547131
                  ],
                  [
                        13.342896,
                        52.547131
                  ],
                  [
                        13.342896,
                        52.466887
                  ],
                  [
                        13.478851,
                        52.466887
                  ]
                ]
          ]
        },
        "properties": {
          "model_type": "mix",
          "parameter_name": "wind_speed_100m_ms",
          "up42.data.scene.netcdf": "87022219-95fc-47f1-b210-e3ca8a629ee8/wind_speed_100m_ms.nc"
        }
  }
]
]
}

Advanced

Examples of other possible variables

VariableMeteomatics nameExample
Relative Humidityrelative_humidity_<level>:<unit>relative_humidity_1000hPa:p
Instantaneous Dew Pointdew_point_<level>:<unit>dew_point_2m:C
Geopotential Heightgeopotential_height_<level>:mgh_500hPa:m
Accumulated Evaporationevaporation_<interval>:<unit>evaporation_1h:mm
Amount of Cloud Cover<level>_cloud_cover:<unit>effective_cloud_cover:octas

Example queries

Example query using time_series and adding one more variable to the variable list:

{
  "meteomatics:1": {
        "bbox": [
          13.233032,
          52.395715,
          13.533783,
          52.577184
        ],
        "variables": [
          "t_2m:C",
          "precip_5min:mm",
          "wind_speed_100m:ms",
          "prob_precip_1h:p"
        ],
        "time_series": [
          "2019-10-01T00:00:00+00:00/2019-10-03T23:59:59+00:00",
          "2018-10-01T00:00:00+00:00/2018-10-03T23:59:59+00:00"
        ],
        "time_interval": 3
  }
}

In this example, we used the time_series parameter and selected two specific time periods. The variable prob_precip_1h:p was also added. In this example we query for each date range in 3 hour intervals for the 4 variables specified above. As described previously the output format is NetCDF.

Output format

{
  "type": "FeatureCollection",
  "features": [
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "t_2m_C",
                "up42.data.scene.netcdf": "3ad49b69-6229-40be-a7e6-f936d7a9fdd5/t_2m_C.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "precip_5min_mm",
                "up42.data.scene.netcdf": "3ad49b69-6229-40be-a7e6-f936d7a9fdd5/precip_5min_mm.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "wind_speed_100m_ms",
                "up42.data.scene.netcdf": "3ad49b69-6229-40be-a7e6-f936d7a9fdd5/wind_speed_100m_ms.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "prob_precip_1h_p",
                "up42.data.scene.netcdf": "3ad49b69-6229-40be-a7e6-f936d7a9fdd5/prob_precip_1h_p.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "t_2m_C",
                "up42.data.scene.netcdf": "7a77f25f-0939-4dae-b66b-0d5434b3d1fd/t_2m_C.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "precip_5min_mm",
                "up42.data.scene.netcdf": "7a77f25f-0939-4dae-b66b-0d5434b3d1fd/precip_5min_mm.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "wind_speed_100m_ms",
                "up42.data.scene.netcdf": "7a77f25f-0939-4dae-b66b-0d5434b3d1fd/wind_speed_100m_ms.nc"
          }
        },
        {
          "type": "Feature",
          "bbox": [
                13.233032,
                52.395715,
                13.533783,
                52.577184
          ],
          "geometry": {
                "type": "Polygon",
                "coordinates": [
                  [
                        [
                          13.533783,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.577184
                        ],
                        [
                          13.233032,
                          52.395715
                        ],
                        [
                          13.533783,
                          52.395715
                        ]
                  ]
                ]
          },
          "properties": {
                "model_type": "mix",
                "parameter_name": "prob_precip_1h_p",
                "up42.data.scene.netcdf": "7a77f25f-0939-4dae-b66b-0d5434b3d1fd/prob_precip_1h_p.nc"
          }
        }
  ]
}