General usage
Welcome to the Weather API! You can query our endpoints to be served different Numerical Weather Prediction (NWP) and reanalysis models in the format of your choice.
We have language bindings in Python! You can view code examples in the dark area to the right.
Authentication
To authenticate, use this code:
import requests
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
response = requests.get(url, headers=headers)
Every request to the API needs to be authenticated with an API key.
The Weather API expects for the API key to be included in all API requests to the server in a header as follows:
Authorization: your_api_key
Parameters
Example basic GET call:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed',
'output-format': 'json'
}
response = requests.get(url, headers=headers, params=params)
Example basic POST call:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed',
'output-format': 'json'
}
response = requests.post(url,
headers=headers,
data=params,
content_type='application/json')
The Weather API expects the following parameters for all endpoints:
Parameter | Required | Description |
---|---|---|
model | Yes | Identifier of the dataset to query |
start-date | Yes | Starting date of requested weather data |
end-date | Yes | Ending date of requested weather data. This date can be in the future when requesting operational forecasts. |
reference-time-freq | Yes | The frequency of the forecasts runs to be returned. E.g. 6H, 12H, 24H |
timezone | No | Timezone used by the request parameters |
valid-time-freq | No | The time frequency of one particular forecast. Usually 1H. Default None. |
forecast-horizon | No | The length of one forecast run. Possible values are: 'latest' - this will return a continuous timeseries with the latest forecast values for a specific valid time; 'full': the entire forecast horizon will be returned for each forecast run; '0, 1, 2, ...': a custom list of lead times (hours) to return |
interpolate | No | Return spatially interpolated values or closest available grid data |
output-format | No | The response output format. Available formats are 'json' and 'netcdf' |
output-schema | No | The schema used to format the output. The values are specific to the output. For 'json' formats, possible values are 'list' or 'xarray'. |
latitude | Yes | A comma separated list of latitudes for the requested locations. E.g. '45.2, 59.2' |
longitude | Yes | A comma separated list of longitudes for the requested locations. E.g. '18.1, 13.4' |
variables | Yes | A comma separated list of the weather variables. When available, specific height levels can be requested for a variable using the notation |
Output formats
The API can return JSON data with different schemas or pre-signed URLS to NetCDF4 files. When JSON data is returned, the output schema can be compatible with pandas DataFrames or with xarray Dataset
JSON output, pandas DataFrame schema
Example with pandas DataFrame:
import requests
import pandas as pd
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-02-01',
'end-date': '2023-02-03',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed',
'output-format': 'json',
'output-schema': 'list'
}
response = requests.get(url, headers=headers, params=params)
df = pd.DataFrame(response.json())
# # Optional: Use hierarchical DatetimeIndex
# df['valid_datetime'] = pd.to_datetime(df['valid_datetime'])
# df['ref_datetime'] = pd.to_datetime(df['ref_datetime'])
# df = df.set_index(['ref_datetime', 'valid_datetime'])
Template of returned JSON:
[{
"ref_datetime": ["2023-02-01T00:00:00Z", "2023-02-01T00:00:00Z", ...],
"valid_datetime": ["2023-02-01T00:00:00Z", "2023-02-01T01:00:00Z", ...],
"Temperature": [-3.92, -4.66, -5.22, -5.64, -6.01, ...],
"WindSpeed": [5.51, 5.55, 5.36, 4.74, 3.7, 2.78, ...],
...
},
{
"ref_datetime": ["2023-02-01T00:00:00Z", "2023-02-01T00:00:00Z", ...],
"valid_datetime": ["2023-02-01T00:00:00Z", "2023-02-01T01:00:00Z", ...],
"Temperature": [-1.33, -2.40, 0.50, 0.70, ...],
"WindSpeed": [6.1, 5.50, 5.20, 4.30, 3.4, ...],
...
}
...
]
Before being serialized to JSON, the DataFrame has a structure similar to the following:
xarray Dataset
Example with xarray Dataset:
import requests
import xarray as xr
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed',
'output-format': 'json',
'output-schema': 'xarray'
}
response = requests.get(url, headers=headers, params=params)
ds = xr.Dataset.from_dict(response.json())
Template of returned JSON:
{
"attrs": {},
"coords": {
"coord_1": {
"attrs": {},
"data": [<coord_1 values>],
"dims": [<coord_1 dimensions>]
}, ...
},
"data_vars": {
"variable_name": {
"attrs": {},
"data": [
[ nesting depth depends on the number
[ of dimensions of the DataArray,
[ here 5 dimensions
[
<value>
]
],
[
[
<value>
]
], ...
]
]
],
"dims": [
"point",
"reference_time",
"valid_time",
"height",
"latitude",
"longitude",
...
]
}, ...
},
"dims": {
"height": <no_height_slices>,
"point": <no_point_index>,
"latitude": <no_latitude_points>,
"longitude": <no_longitude_points>,
"reference_time": <no_reference_times>,
"valid_time": <length_forecast_horizon,
...
}
}
Before being serialized to JSON, the Dataset has a structure similar to the following:
For more information about the elements of a xarray Dataset, please refer to xarray's data structures.
The structure of the JSON returned by the API is presented in the json tab of the right column.
URL to NetCDF4 file
Example with NetCDF4 url:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed',
'output-format': 'netcdf'
}
response = requests.get(url, headers=headers, params=params)
netcdf_url = response.json()['file']
Template of returned JSON:
{
"create_time": <datetime_link_created>,
"file": <pre-signed URL>
}
A pre-signed URL to the NetCDF file stored in a S3 bucket, that you can download with the mean of your choice, e.g. your web browser, a cURL command or simply a HTTP GET request. Recommended when the queried data starts to grow in size. Expires after one week.
Endpoints
query
Returns the weather forecast data according to the query parameters for a model.
Example call for query:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed'
}
response = requests.get(url, headers=headers, params=params)
point/operational
Returns the latest weather forecast data according to the query parameters for a model.
Example call for point/operational:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/point/operational"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed:10'
}
response = requests.get(url, headers=headers, params=params)
point/historical
Returns the historical weather forecast data according to the query parameters for a model.
Example call for point/historical:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/point/historical"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed:10'
}
response = requests.get(url, headers=headers, params=params)
area/operational
Returns the latest weather forecast data on a grid specified by the latitude and longitude coordinate list for a model.
Example call for area/operational, xarray output schema:
import requests
import xarray as xr
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/area/operational"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed:10',
'output-format': 'xarray'
}
response = requests.get(url, headers=headers, params=params)
ds = xr.Dataset.from_dict(response.json())
print(ds)
area/historical
Returns historical weather forecast data on a grid specified by the latitude and longitude coordinate list for a model.
Example call for area/historical, xarray output schema:
import requests
import xarray as xr
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/area/historical"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed:10',
'output-format': 'xarray'
}
response = requests.get(url, headers=headers, params=params)
ds = xr.Dataset.from_dict(response.json())
print(ds)
Events
New forecast dissemination events are published on a Kafka Server under the datahub_weather topic. The Kafka Server exposes a REST API which can be used to create consumers, subscribe to topics and retrieve latest events.
Authentication is based on the same API keys that are used to query the forecast endpoints.
The servers allows multiple consumers and consumer intances for a single topic.
Create a Kafka consumer and a consumer instance
This request will create a consumer named my_consumer and a consumer instance named my_consumer_instance_1:
curl -X POST -H "Content-Type: application/vnd.kafka.v2+json" \
-H "Authorization: [API_KEY]" \
--data '{"name": "my_consumer_instance_1", "format": "json", "auto.offset.reset": "latest"}' \
https://events.rebase.energy/rest/consumers/my_consumer
Returns:
{
"instance_id": "my_consumer_instance_1",
"base_uri": "https://events.rebase.energy/rest/consumers/my_consumer/instances/my_consumer_instance_1"
}
Subscribe the consumer instance my_consumer_instance_1 to the datahub_weather topic
This request will subscribe the consumer instance my_consumer_instance_1 to the datahub_weather topic.
curl -X POST -H "Content-Type: application/vnd.kafka.v2+json" \
-H "Authorization: [API_KEY]" \
--data '{"topics":["datahub_weather"]}' \
https://events.rebase.energy/rest/consumers/my_consumer/instances/my_consumer_instance_1/subscription
Returns HTTP Code 204 with no content.
Receive latest events
This request will receive all unread events of the consumer instance my_consumer_instance_1.
curl -X GET -H "Accept: application/vnd.kafka.json.v2+json" \
-H "Authorization: [API_KEY]" \
https://events.rebase.energy/rest/consumers/my_consumer/instances/my_consumer_instance_1/records
Returns an array with the latest unread messages.
[{
"id": "e837844d-a8a5-445f-a9a6-f569d59d9a60",
"timestamp: "2022-09-29T18:16:05.273290+00:00",
"type": 1,
"model": "MetNo_HIRESMEPS",
"reference_time": "2022-09-29T17:00Z",
"message": "New forecast published",
"info": ""
},
...]
Schema:
Key | Description |
---|---|
model | the model identifier |
timestamp | UTC timestamp when the forecast has been published on our platform |
type | always 1 |
reference_time | the forecast reference time start |
message | typically information about the forecast |
info | any additional info about the forecast issued |
Reference
Additional help: https://developer.confluent.io/get-started/rest/?_ga=2.91944543.47573013.1664830252-518093079.1664460550#consume-events
Post-processed variables
Different datasets having different naming and unit conventions, we post-process some variables to make it easier for you to query several datasets at once. The post-processing transformations are explained in each datasets' variables section. The available post-process variables are the following:
Name | Description | DWD-ICON-EU | DWD-ICON-D2 | NCEP-GFS | ECMWF-HiRes | ECMWF-HiRes-Operational | ECMWF-HiRes-Mix | ECMWF-ERA5 | ECMWF-ERA5-land | MetNo-MEPS | MetNo-HiRes | MeteoFrance-ARPEGE_EU | MeteoFrance_AROME | MeteoFrance_AROME-HD | MetOffice-GlobalHiRes | SMHI-MESAN | REBASE_AI |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Temperature | Temperature at 2m (°C) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
WindSpeed | Wind speed at 10m (m.s-1) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
WindDirection | Wind direction at 10m (°) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
WindSpeed:100 | Wind speed at 100m (m.s-1) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✖ | ✖ | ✖ | ✔ | ✔ | ✔ | ✔ | ✖ | ✖ |
WindDirection:100 | Wind direction at 100m (°) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✖ | ✖ | ✖ | ✔ | ✔ | ✔ | ✔ | ✖ | ✖ |
CloudCover | Cloud cover fraction (0-1) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✖ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✖ |
RelativeHumidity | Relative humidity at 2m (%) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
PressureReducedMSL | Pressure at mean sea level (Pa) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✖ | ✔ | ✔ | ✔ | ✔ | ✖ | ✔ | ✔ | ✔ |
SolarDownwardRadiation | Surface solar radiation (W.m-2) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✖ | ✔ | ✖ | ✖ |
TotalPrecipitation | Surface total precipitation (kg.m-2) | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Datasets
ICON Europe (DWD), identifier: DWD_ICON-EU
Example call for DWD_ICON-EU:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed, CloudCover'
}
response = requests.get(url, headers=headers, params=params)
Local nest over Europe of the ICOsahedral Nonhydrostatic model (ICON) developed jointly by Deutscher Wetterdienst (DWD) and the Max-Planck Institute for Meteorology in Hamburg (MPI-M) (documentation).
Geographical coverage and resolution: numbers, visualization
Time range and run times: from 2019-03-05 09:00 UTC to present. The model is ran every 3 hours (00, 03, 06, 09, 12, 15, 18, 21 UTC).
Forecast horizon and resolution: 5 days horizon for 00, 06, 12 and 18 runs: 79 steps with hourly resolution, 14 with 3-hourly resolution. 30 hours horizon for runs 03, 09, 15 and 21: 31 steps with hourly resolution.
Variables
Name | Description |
---|---|
T | Temperature in Kelvin (K), at several heights (GRIB variable documentation) |
T_2M | Temperature in Kelvin (K), at 2m above ground (#dimensions) (GRIB variable documentation) |
U | Zonal wind in meters per second (m.s-1), at several heights (GRIB variable documentation) |
V | Meridional wind in meters per second (m.s-1), at several heights (GRIB variable documentation) |
U_10m | Zonal wind in meters per second (m.s-1), at 10m above ground (#dimensions) (GRIB variable documentation) |
V_10m | Meridional wind in meters per second (m.s-1), at 10m above ground (#dimensions) (GRIB variable documentation) |
CLCT | Total cloud cover in percents (%) (GRIB variable documentation) |
CLCL | Low cloud cover (800hPa-Soil) in percents (%) (GRIB variable documentation) |
CLCM | Medium cloud cover (400-800 hPa) in percents (%) (GRIB variable documentation) |
CLCH | High cloud cover (0-400 hPa) in percents (%) (GRIB variable documentation) |
ASOB_S | Net short wave radiation flux (m) (at the surface) in Watt per square meter (W.m-2). Only available from 2019-08-15 06:00:00 UTC onwards |
ASWDIFD_S | Surface down solar diffuse radiation (average since model start) in Watt per square meter (W.m-2). Only available from 2019-08-15 06:00:00 UTC onwards |
ASWDIR_S | Surface down solar direct radiation (average since model start) in Watt per square meter (W.m-2). Only available from 2019-08-15 06:00:00 UTC onwards |
RELHUM_2M | Relative humidity in percents (%) at 2 meters above the surface (GRIB variable documentation). Only available from 2020-08-05 06:00:00 UTC onwards |
PMSL | Pressure in Pascals (Pa) reduced to mean sea level(GRIB variable documentation). Only available from 2019-08-06 06:00:00 UTC onwards |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from T_2M |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from U_10m and V_10m |
WindDirection | Wind direction at 10m in degrees (°) derived from U_10m and V_10m |
WindSpeed:100 | Wind speed at 100m in meters per second (m.s-1) derived from U and V |
WindDirection:100 | Wind direction at 100m in degrees (°) derived from U and V |
CloudCover | Cloud cover fraction (0-1) derived from CLCT |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from RELHUM_2M |
PressureReducedMSL | Pressure at mean sea level pressure in Pascals (Pa) derived from PMSL |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from ASOB_S |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from TOT_PREC |
Dimensions
Name | Description |
---|---|
height | Height in meters, levels 65 to 74, cf. table |
latitude | 29.5°N to 70.5°N with a resolution of ~0.0625° |
longitude | -23.5°E to 45.0°E with a resolution of ~0.0625° |
ICON-D2 (DWD), identifier: DWD_ICON-D2
Example call for DWD_ICON-D2:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'DWD_ICON-D2',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '3H',
'forecast-horizon': 'full',
'latitude': '52.50, 53.16',
'longitude': '13.32, 10.81',
'variables': 'Temperature, WindSpeed, CloudCover'
}
response = requests.get(url, headers=headers, params=params)
Local nest around Germany of the ICOsahedral Nonhydrostatic model (ICON) developed jointly by Deutscher Wetterdienst (DWD) and the Max-Planck Institute for Meteorology in Hamburg (MPI-M) (documentation).
Geographical coverage and resolution: visualization
Time range and run times: from 2020-08-01 00:00 UTC to present. The model is ran every 3 hours (00, 03, 06, 09, 12, 15, 18 and 21 UTC).
Forecast horizon and resolution: 27 hours horizon for all runs: 109 steps with 15 minutes resolution or 28 with hourly resolution, depending on the variable.
Variables
Name | Description |
---|---|
T | Temperature in Kelvins (K) at different heights (GRIB variable documentation) |
T_2M | Temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
U | U-component of wind in meters per second (m.s-1) at different heights (GRIB variable documentation) |
U_10M | U-component of wind in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
V | V-component of wind in meters per second (m.s-1) at different heights (GRIB variable documentation) |
V_10M | V-component of wind in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
CLCT | Total cloud cover in percents (%) (GRIB variable documentation) |
CLCL | Low cloud cover (800hPa-Soil) in percents (%) (GRIB variable documentation) |
CLCM | Medium cloud cover (400-800 hPa) in percents (%) (GRIB variable documentation) |
CLCH | High cloud cover (0-400 hPa) in percents (%) (GRIB variable documentation) |
CLCT_MOD | Modified cloud cover for media (GRIB variable documentation) |
CLC | Cloud cover in percents (%) at different heights (GRIB variable documentation) |
RELHUM_2M | Relative humidity in percents (%) at 2 meters above the surface (GRIB variable documentation) |
PMSL | Pressure in Pascals (Pa) reduced to mean sea level (GRIB variable documentation) |
RAIN_GSP | Large-scale rain accumulation in kilos per square meter (kg.m-2) (GRIB variable documentation) |
TOT_PREC | Total precipitation in kilograms per square meter (kg.m-2) (GRIB variable documentation) |
RUNOFF_G | Soil water runoff (accumulated since model start) in kilos per square meter (kg.m-2) (GRIB variable documentation) |
RUNOFF_S | Surface water runoff (accumulated since model start) in kilos per square meter (kg.m-2) (GRIB variable documentation) |
RHO_SNOW | Snow density in kilos per cubic meter (kg.m-3) (GRIB variable documentation) |
SNOWLMT | Height in meters (m) of snowfall limit above mean sea level (GRIB variable documentation) |
SNOW_GSP | Large-scale snowfall accumulation |
TKE | Turbulent kinetic energy in Joules per kilogram (J.kg-1) (GRIB variable documentation) |
SOILTYP | Soil type (1-9) (GRIB variable documentation) |
ROOTDP | Root depth in meters (m) of vegetation (GRIB variable documentation) |
ASOB_S | Net short wave radiation flux (m) (at the surface) in Watt per square meter (W.m-2). Only available from 2023-08-03 12:00:00 UTC onwards |
ASWDIFD_S | Surface down solar diffuse radiation (average since model start) in Watt per square meter (W.m-2). Only available from 2023-08-03 12:00:00 UTC onwards |
ASWDIR_S | Surface down solar direct radiation (average since model start) in Watt per square meter (W.m-2). Only available from 2023-08-03 12:00:00 UTC onwards |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from T |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from U_10M and V_10M |
WindDirection | Wind direction at 10m in degrees (°) derived from U_10M and V_10M |
CloudCover | Cloud cover fraction (0-1) derived from CLCT |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from RELHUM_2M |
PressureReducedMSL | Pressure at mean sea level in Pascals (Pa) derived from PMSL |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from ASOB_S |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from TOT_PREC |
Dimensions
Name | Description |
---|---|
height | Height in meters, levels 56 to 65, cf. table |
latitude | 43.0°N to 58.2°N with a resolution of ~2km |
longitude | -4.15°E to 20.55°E with a resolution of ~2km |
GFS (NCEP), identifier: NCEP_GFS
Example call for NCEP_GFS:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'NCEP_GFS',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature_Height:80.0, CloudCover'
}
response = requests.get(url, headers=headers, params=params)
Global Forecast System (GFS) produced by the National Centers for Environmental Prediction (NCEP) (general documentation, scientific documentation).
Geographical coverage and resolution: global coverage wih 0.25 latitude and longitude resolution
Time range and run times: from 2019-06-24 06:00 UTC to present. The model is ran every 6 hours (00, 06, 12, 18 UTC).
Forecast horizon and resolution: 16 days horizon for all runs: 121 steps with hourly resolution, 88 with 3 hours resolution.
Variables
Name | Description |
---|---|
WindGust | Wind speed (gust) in meters per second (m.s-1) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
WindUMS_Height | U-component of wind in meters per second (m.s-1), at several heights (lv_HTGL8) (GRIB variable documentation) |
WindVMS_Height | V-component of wind in meters per second (m.s-1), at several heights (lv_HTGL8) (GRIB variable documentation) |
WindUMS_Isobar | U-component of wind in meters per second (m.s-1), at several isobaric heights (lv_ISBL5) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
WindVMS_Isobar | V-component of wind in meters per second (m.s-1), at several isobaric heights (lv_ISBL5) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
StormMotionU_Height | U-component storm motion, in meters per second (m.s-1) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
StormMotionV_Height | V-component storm motion, in meters per second (m.s-1) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
StormRelativeHelicity_Height | Storm relative helicity in square meters per square seconds (m2.s-2) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
SurfacePressure | Pressure at surface level in Pascal (Pa) (GRIB variable documentation) |
PressureReducedMSL | Pressure at mean sea level in Pascal (Pa) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
RelativeHumidity_Isobar | Relative humidity in percents (%), at several isobaric heights (lv_ISBL5) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
RelativeHumidity_Height | Relative humidity in percents (%) (GRIB variable documentation) |
PrecipitableWater | Precipitable water in kilos per square meters (kg.m-2) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
SurfacePrecipitationRate | Precipitation rate at the surface in kilos per square meters per seconds (kg.m-2.s-1) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
SurfacePrecipitationRateAvg | Average precipitation rate at the surface in kilos per square meters per seconds (kg.m-2.s-1) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
SurfaceTotalPrecipitation | Accumulated total precipitation at the surface in kilos per square meters (kg.m-2) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
SurfaceSnowDepth | Snow depth at the surface in meters (m) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
SurfaceWaterEqAccSnowDepth | Water equivalent of accumulated snow depth at the surface in kilos per square meters (kg.m-2) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
Temperature_Height | Temperature in Kelvin (K), at several heights (lv_HTGL2) (GRIB variable documentation) |
PotentialTemperature_Sigma | Potential temperature in Kelvin (K) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
SoilMoisture_Depth | Volumetric soil moisture content in fraction, at several depths (lv_DBLL14) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
SoilTemperature_Depth | Soil temperature in Kelvin (K), at several depths (lv_DBLL14) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
PlanetaryBoundaryLayer_Height | Planetary boundary layer height in meters (m) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
CloudCover_Isobar | Total cloud cover in percent (%), at several isobaric heights (lv_ISBL7) (GRIB variable documentation) |
SurfaceRadiationShortWaveDownAvg | Average downward short-wave radiation flux in Watts per square meters (W.m-2) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
SurfaceRadiationShortWaveUpAvg | Average upward long-wave radiation flux in Watts per square meters (W.m-2) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
SurfaceRadiationLongWaveDownAvg | Average downward long-wave radiation flux in Watts per square meters (W.m-2) (GRIB variable documentation). Only available from 2019-09-02 06:00:00 UTC onwards |
SurfaceLatentHeatNetFluxAvg | Average latent heat net flux at the surface in Watts per square meters (W.m-2) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
SurfaceSensibleHeatNetFluxAvg | Average sensible heat net flux at the surface in Watts per square meters (W.m-2) (GRIB variable documentation). Only available from 2020-03-04 00:00:00 UTC onwards |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from Temperature_Height |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from WindUMS_Height and WindVMS_Height |
WindDirection | Wind direction at 10m in degrees (°) derived from WindUMS_Height and WindVMS_Height |
CloudCover | Cloud cover fraction (0-1) derived from CloudCover_Isobar |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from RelativeHumidity_Height |
PressureReducedMSL | Pressure at mean sea level in Pascals (Pa) derived from PressureReducedMSL |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from SurfaceRadiationShortWaveDownAvg |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from SurfaceTotalPrecipitation |
Dimensions
Name | Description |
---|---|
lv_HTGL2 | Height in meters in the ensemble {2.0; 80.0; 100.0} |
lv_HTGL8 | Height in meters in the ensemble {10.0; 20.0; 30.0; 40.0; 50.0; 80.0; 100.0} |
lv_ISBL5 | Isobaric surfaces in Pascals in the ensemble {90000.0; 92500.0} (explanation of constant pressure surfaces). |
lv_ISBL7 | Isobaric surfaces in Pascals in the ensemble {5000.0; 10000.0; 15000.0; 20000.0; 25000.0; 30000.0; 35000.0; 40000.0; 45000.0; 50000.0; 55000.0; 60000.0; 65000.0; 70000.0; 75000.0; 80000.0; 85000.0; 90000.0; 92500.0; 95000.0; 97500.0; 100000.0} (explanation of constant pressure surfaces) |
lv_DBLL14 | Depth layers in the ensemble {0; 1; 2; 3}, respectively corresponding to {[0-0.1]; [0.1-0.4]; [0.4-1]; [1-2]} meters below ground |
latitude | -90.0°N to 90.0°N with a resolution of ~0.25° |
longitude | 0.0°E to 359.75°E with a resolution of ~0.25° |
MEPS (MetNo), identifier: MetNo_MEPS
Example call for MetNo_MEPS:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'MetNo_MEPS',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'air_temperature_z:80.0, WindSpeed, WindDirection'
}
response = requests.get(url, headers=headers, params=params)
MEPS (The MetCoOp Ensemble Prediction System) is a 10-member short-range convection permitting ensemble prediction system produced by MetCoOp, the Meterological Cooperation on Operational Numeric Weather Prediction (NWP) between Finnish Meteorological Institute (FMI), MET Norway and Swedish Meteorological and Hydrological Institute (SMHI) (documentation). The data available through the Weather API corresponds to the first ensemble, the control run, which is not perturbed.
Geographical coverage and resolution: latitudes 49.75 to 75.20°N, longitudes -18.15 to 54.20°E (interactive)
Time range and run times: from 2018-01-01 00:00 UTC to present. The model is ran every 6 hours (00, 06, 12, 18 UTC).
Forecast horizon and resolution: 66 hours horizon for all runs: 67 steps with hourly resolution.
Variables
Name | Description |
---|---|
x_wind_10m | U-component of wind in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
y_wind_10m | V-component of wind in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
x_wind_z | U-component of wind in meters per second (m.s-1), at several heights (height2) (GRIB variable documentation) |
y_wind_z | V-component of wind in meters per second (m.s-1), at several heights (height2) (GRIB variable documentation) |
air_pressure_at_sea_level | Mean sea level pressure in Pascal (Pa) (GRIB variable documentation) |
air_temperature_0m | Surface air temperature in Kelvin (K) (GRIB variable documentation) |
air_temperature_2m | Air temperature in Kelvin (K) at 2 meters above ground (GRIB variable documentation) |
air_temperature_z | Air temperature in Kelvin (K), at several heights (height2) (GRIB variable documentation) |
relative_humidity_2m | Relative humidity in proportion (0-1) at 2 meters above ground |
relative_humidity_z | Relative humidity in proportion (0-1) at several heights (height2) |
cloud_area_fraction | Total cloud cover in proportion (0-1) (GRIB variable documentation) |
low_type_cloud_area_fraction | Low cloud cover in proportion (0-1) |
medium_type_cloud_area_fraction | Medium cloud cover in proportion (0-1) |
high_type_cloud_area_fraction | High cloud cover in proportion (0-1) |
integral_of_rainfall_amount_wrt_time | Accumulated rainfall at surface in kilograms per square meters (kg.m-2) |
integral_of_surface_net_downward _shortwave_flux_wrt_time |
Accumulated net downward surface short-wave radiation in Watts second per square meters (W.s.m-2) |
symbols | String describing the weather conditions (list of possible values) |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from air_temperature_2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from x_wind_10m and y_wind_10m |
WindDirection | Wind direction at 10m in degrees (°) derived from x_wind_10m and y_wind_10m |
CloudCover | Cloud cover fraction (0-1) derived from cloud_area_fraction |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from relative_humidity_2m |
PressureReducedMSL | Pressure at mean sea level in Pascals (Pa) derived from air_pressure_at_sea_level |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from integral_of_surface_net_downward _shortwave_flux_wrt_time |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from integral_of_rainfall_amount_wrt_time |
Dimensions
Name | Description |
---|---|
height2 | Height in meters in the ensemble {80.0; 100.0} |
latitude | 49.75 to 75.20°N with a resolution of ~0.1° |
longitude | -18.15 to 54.20°E with a resolution of ~0.4° |
MEPS High Resolution (MetNo), identifier: MetNo_HIRESMEPS
Example call for MetNo_HIRESMEPS:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'MetNo_HIRESMEPS',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'air_temperature_2m, relative_humidity_2m'
}
response = requests.get(url, headers=headers, params=params)
MEPS (The MetCoOp Ensemble Prediction System) is a 10-member short-range convection permitting ensemble prediction system produced by MetCoOp, the Meterological Cooperation on Operational Numeric Weather Prediction (NWP) between Finnish Meteorological Institute (FMI), MET Norway and Swedish Meteorological and Hydrological Institute (SMHI) (documentation). The data available through the Weather API corresponds to a subset of the first ensemble, the control run, which is not perturbed.
Geographical coverage and resolution: latitudes 52.3 to 73.8°N, longitudes -11.8 to 41.7°E (interactive)
Time range and run times: from 2020-03-02 14:00 UTC to present. The model is ran every hour.
Forecast horizon and resolution: between 56 and 58 hours for all runs: 57 to 59 steps with hourly resolution.
Variables
Name | Description |
---|---|
air_pressure_at_sea_level | Mean sea level pressure in Pascal (Pa) (GRIB variable documentation) |
air_temperature_2m | Air temperature in Kelvin (K) at 2 meters above ground (GRIB variable documentation) |
relative_humidity_2m | Relative humidity in proportion (0-1) at 2 meters above ground |
cloud_area_fraction | Total cloud cover in proportion (0-1) (GRIB variable documentation) |
altitude | Surface altitude in meters (m) |
wind_direction_10m | Wind direction in degrees (∈[0;360])(°) at 10 meters above ground |
wind_speed_10m | Wind speed in meters per second (m.s-1) at 10 meters above ground |
wind_speed_of_gust | Wind speed of gust in meters per second (m.s-1) |
integral_of_surface_downwelling _shortwave_flux_in_air_wrt_time |
Integral of surface downwelling short-wave flux in air with respect to time in Watts second per square meter (W.s.m-2) |
land_area_fraction | Proportion (0-1) of land in the grid box(GRIB variable documentation) |
precipitation_amount | Precipitation amount in kilograms per square meter (kg.m-2) |
symbols | String describing the weather conditions (list of possible values) |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from air_temperature_2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from wind_speed_10m |
WindDirection | Wind direction at 10m in degrees (°) derived from wind_direction_10m |
CloudCover | Cloud cover fraction (0-1) derived from cloud_area_fraction |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from relative_humidity_2m |
PressureReducedMSL | Pressure at mean sea level in Pascals (Pa) derived from air_pressure_at_sea_level |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from integral_of_surface_downwelling _shortwave_flux_in_air_wrt_time |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from precipitation_amount |
Dimensions
Name | Description |
---|---|
latitude | 52.3 to 73.8°N with a resolution of ~0.0036° |
longitude | -11.8 to 41.7°E with a resolution of ~0.0117° |
ARPEGE Europe (Meteo France), identifier: MeteoFrance_ARPEGE-EU
Example call for MeteoFrance_ARPEGE-EU:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'MeteoFrance_ARPEGE-EU',
'start-date': '2023-08-01',
'end-date': '2023-08-03',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed_height:20, SurfaceTotalCloudCover'
}
response = requests.get(url, headers=headers, params=params)
Local nest over Europe of the global numerical weather prediction model ARPEGE (Action de Recherche Petite Echelle Grande Echelle) provided by Météo France (general documentation, scientific documentation).
Geographical coverage and resolution: latitudes 20.0 to 72.0°N, longitudes -32.0 to 42.0°E with 0.1° step in both directions visualisation
Time range and run times: from 2020-03-18 06:00 UTC to present. The model is ran every 6 hours (00, 06, 12, 18 UTC).
Forecast horizon and resolution: 114 hours horizon for run 12: 115 steps with hourly resolution. 102 hours horizon for run 00: 103 steps with hourly resolution. 72 hours horizon for run 06: 73 steps with hourly resolution. 60 hours horizon for run 18: 61 steps with hourly resolution.
Variables
Name | Description |
---|---|
DownwardLongWaveRadiationFluxAvg | Average downward long wave radiation flux in Watts per square meter (W.m-2) at the surface (GRIB variable documentation) |
HighCloudCover | High cloud cover in percents (%) at the surface (GRIB variable documentation) |
LowCloudCover | Low cloud cover in percents (%) at the surface (GRIB variable documentation) |
MediumCloudCover | Medium cloud cover in percents (%) at the surface (GRIB variable documentation) |
PressureMSL | Mean sea level pressure in Pascals (Pa) (GRIB variable documentation) |
SnowMeltAvg | Average snow melt in kilos per square meter (kg.m-2) at the surface (GRIB variable documentation) |
SurfaceDewPointTemperature | Dew point temperature in Kelvins (K) at 2 meters above ground (GRIB variable documentation) |
SurfaceDownwardShortWaveRadiationFluxAvg | Average downward short wave radiation flux in Watts per square meter (W.m-2) at the surface (GRIB variable documentation) |
SurfaceRelativeHumidity | Relative humidity in percents (%) at 2 meters above ground (GRIB variable documentation) |
SurfaceSpecificHumidity | Specific humidity in kilos per kilo (kg.kg-1) at 2 meters above ground (GRIB variable documentation) |
SurfaceTotalCloudCover | Total cloud cover in percents (%) at the surface (GRIB variable documentation) |
SurfaceWindDirection | Direction from which the wind blows in degrees true (°) at 10 meters above ground (GRIB variable documentation) |
SurfaceWindSpeed | Wind speed in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
SurfaceWindSpeedGust | Wind speed (gust) in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
SurfaceWindU | U-component of wind in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
SurfaceWindUGust | U-component of wind speed (gust) in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
SurfaceWindV | V-component of wind in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
SurfaceWindVGust | V-component of wind speed (gust) in meters per second (m.s-1) at 10 meters above ground (GRIB variable documentation) |
Temperature2m | Temperature in Kelvin (K) at 2 meters above ground (GRIB variable documentation) |
TotalPrecipitationRateAcc | Accumulated (since reference time) total precipitation rate at the surface in kilos per square meter per second (kg.m-2.s-1) (GRIB variable documentation) |
WindDirection_Height | Direction from which the wind blows in degrees true (°) at different heights (GRIB variable documentation) |
WindSpeed_height | Wind speed in meters per second (m.s-1) at different heights (GRIB variable documentation) |
WindU_Height | U-component of wind in meters per second (m.s-1) at different heights (GRIB variable documentation) |
WindV_Height | V-component of wind in meters per second (m.s-1) at different heights (GRIB variable documentation) |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from Temperature2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from SurfaceWindSpeed |
WindDirection | Wind direction at 10m in degrees (°) derived from SurfaceWindDirection |
WindSpeed:100 | Wind speed at 100m in meters per second (m.s-1) derived from WindSpeed_height |
WindDirection:100 | Wind direction at 100m in degrees (°) derived from WindDirection_height |
CloudCover | Cloud cover fraction (0-1) derived from SurfaceTotalCloudCover |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from SurfaceRelativeHumidity |
PressureReducedMSL | Pressure at mean sea level in Pascals (Pa) derived from PressureMSL |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from SurfaceDownwardShortWaveRadiationFluxAvg |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from TotalPrecipitationRateAcc |
Dimensions
Name | Description |
---|---|
lv_HTGL0 | Height in meters in the ensemble {20, 35, 50, 75, 100, 150, 200, 250, 375, 500, 625, 750, 875, 1000, 1125, 1250, 1375, 1500, 1750, 2000, 2250, 2500, 2750, 3000} |
latitude | 20.0°N to 72.0°N with a resolution of ~0.1° |
longitude | -32.0°E to 42.0°E with a resolution of ~0.1° |
AROME France (Meteo France), identifier: MeteoFrance_AROME
Example call for MeteoFrance_AROME:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'MeteoFrance_AROME',
'start-date': '2024-09-22',
'end-date': '2024-09-23',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '42.1, 43.1, 45.3',
'longitude': '1.2, 3.1, 5.05',
'variables': 'WindSpeed, WindDirection'
}
response = requests.get(url, headers=headers, params=params)
Geographical coverage and resolution: latitudes 38.0 to 53.0°N, longitudes -8.0 to 12.0°E with 0.025° step in both directions
Time range and run times: from 2024-09-22 00:00 UTC to present. The model is ran every 6 hours (00, 06, 12, 18 UTC).
Forecast horizon and resolution: 42 hours horizon.
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from Temperature2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Wind direction at 10m in degrees (°) derived from u10 and v10 |
WindSpeed:100 | Wind speed at 100m in meters per second (m.s-1) derived from u100 and v100 |
WindDirection:100 | Wind direction at 100m in degrees (°) derived from u100 and v100 |
CloudCover | Cloud cover fraction (0-1) derived from lcc, mcc and hcc |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from r2 |
PressureReducedMSL | Pressure at mean sea level in Pascals (Pa) derived from prmsl |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from ssrd |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | 38.0°N to 53.0°N with a resolution of ~0.025° |
longitude | -8.0°E to 12.0°E with a resolution of ~0.025° |
AROME-HD France (Meteo France), identifier: MeteoFrance_AROME-HD
Example call for MeteoFrance_AROME-HD:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'MeteoFrance_AROME-HD',
'start-date': '2024-09-22',
'end-date': '2024-09-23',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '42.1, 43.1, 45.3',
'longitude': '1.2, 3.1, 5.05',
'variables': 'WindSpeed, WindDirection'
}
response = requests.get(url, headers=headers, params=params)
Geographical coverage and resolution: latitudes 37.5 to 55.4°N, longitudes -12.0 to 16.0°E with 0.01° step in both directions
Time range and run times: from 2024-09-22 00:00 UTC to present. The model is ran every 6 hours (00, 06, 12, 18 UTC).
Forecast horizon and resolution: 42 hours horizon.
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from Temperature2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Wind direction at 10m in degrees (°) derived from u10 and v10 |
WindSpeed:100 | Wind speed at 100m in meters per second (m.s-1) derived from u100 and v100 |
WindDirection:100 | Wind direction at 100m in degrees (°) derived from u100 and v100 |
CloudCover | Cloud cover fraction (0-1) derived from lcc, mcc and hcc |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from r2 |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | 37.5°N to 55.4°N with a resolution of ~0.01° |
longitude | -12.0°E to 16.0°E with a resolution of ~0.01° |
ERA5 (ECMWF), identifier: ECMWF_ERA5
Example call for ECMWF_ERA5:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_ERA5',
'start-date': '2021-02-01',
'end-date': '2021-02-05',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 't2m, msl'
}
response = requests.get(url, headers=headers, params=params)
ERA5 (ECMWF ReAnalysis 5) is the fifth generation atmospheric reanalysis of the global climate provided by ECMWF (documentation). Reanalysis combines model data with observations from across the world into a globally complete and consistent dataset using the laws of physics.
Geographical coverage and resolution: global coverage with 0.25° resolution.
Time range and resolution: from 1979-01-01 00:00 UTC to 7 days ago, with a time resolution of 1 hour.
Variables
Name | Description |
---|---|
msl | Air pressure at mean sea level in Pascals (Pa) (GRIB variable documentation) |
t2m | Temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
mx2t | Maximum temperature since previous post-processing in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
mn2t | Minimum temperature since previous post-processing in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
d2m | Dew point temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
u100 | U-component of wind in meters per second (m.s-1) at 100 meters above the surface (GRIB variable documentation) |
u10 | U-component of wind in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
ssrd | Surface solar radiation downwards in Joules per square meter (J.m-2) (GRIB variable documentation) |
sd | Snow depth at the surface in meters of water equivalent (GRIB variable documentation) |
v100 | V-component of wind in meters per second (m.s-1) at 100 meters above the surface (GRIB variable documentation) |
v10 | V-component of wind in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
tp | Total precipitation in meters (GRIB variable documentation) |
rsn | Snow density in kilograms per cubic meter (kg.m-3) (GRIB variable documentation) |
sp | Air pressure in Pascals (Pa) at the surface (GRIB variable documentation) |
tcc | Total cloud cover in fraction (0-1) (GRIB variable documentation) |
hcc | High cloud cover in fraction (0-1) (GRIB variable documentation) |
mcc | Medium cloud cover in fraction (0-1) (GRIB variable documentation) |
lcc | Low cloud cover in fraction (0-1) (GRIB variable documentation) |
ssr | Surface net solar radiation in Joules per square meter (J.m-2) (GRIB variable documentation) |
lspf | Large-scale precipitation fraction in seconds (s) (GRIB variable documentation) |
i10fg | Instantaneous 10 metres wind gust in meters per second (m.s-1) (GRIB variable documentation) |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from t2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Wind direction at 10m in degrees (°) derived from u10 and v10 |
WindSpeed:100 | Wind speed at 100m in meters per second (m.s-1) derived from u100 and v100 |
WindDirection:100 | Wind direction at 100m in degrees (°) derived from u100 and v100 |
CloudCover | Cloud cover fraction (0-1) derived from tcc |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from t2m and d2m |
PressureReducedMSL | Pressure at mean sea level pressure in Pascals (Pa) derived from msl |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from ssr |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | -90.0°N to 90.0°N of ~0.25° |
longitude | 0.0°E to 359.75°E with a resolution of ~0.25° |
ERA5-land (ECMWF), identifier: ECMWF_ERA5-land
Example call for ECMWF_ERA5-land:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_ERA5-land',
'start-date': '2021-02-01',
'end-date': '2021-02-05',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, SolarDownwardRadiation'
}
response = requests.get(url, headers=headers, params=params)
ERA5-land (ECMWF ReAnalysis 5 land) is the fifth generation atmospheric reanalysis of the global climate provided by ECMWF (documentation). Reanalysis combines model data with observations from across the world into a globally complete and consistent dataset using the laws of physics.
Geographical coverage and resolution: global coverage with 0.125° resolution.
Time range and resolution: from 2011-01-01 00:00 UTC to 7 days ago, with a time resolution of 1 hour.
Variables
Name | Description |
---|---|
t2m | Temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
d2m | Dew point temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation |
u10 | U-component of wind in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
v10 | V-component of wind in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
ssrd | Surface solar radiation downwards in Joules per square meter (J.m-2) (GRIB variable documentation) |
tp | Total precipitation in meters (GRIB variable documentation) |
sp | Air pressure in Pascals (Pa) at the surface (GRIB variable documentation) |
ssr | Surface net solar radiation in Joules per square meter (J.m-2) (GRIB variable documentation) |
ssrd | Surface solar radiation downwards in Joules per square meter (J.m-2) ([GRIB variable documentation](https://apps.ecmwf.int/ |
codes/grib/param-db/?id=169) sro | Surface runoff (m) (GRIB variable documentation
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from t2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Wind direction at 10m in degrees (°) derived from u10 and v10 |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from t2m and d2m |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from ssr |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | -90.0°N to 90.0°N of ~0.125° |
longitude | 0.0°E to 359.75°E with a resolution of ~0.125° |
MESAN (SMHI), identifier: SMHI_MESAN
Example call for SMHI_MESAN:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'SMHI_MESAN',
'start-date': '2019-02-01',
'end-date': '2019-02-10',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'Temperature, WindSpeed, asngrd'
}
response = requests.get(url, headers=headers, params=params)
MESAN is a meteorological reanalysis model provided by SMHI that describes the current weather conditions in grid tiles (documentation). The model also serves as a complement to observations as the number of measuring stations is limited.
Geographical coverage and resolution: latitudes 52.4 to 72.6°N, longitudes -9.6 to 39.2 with 0.1° step in both directions visualisation.
Time range and resolution: from 2014-12-04 00:00 UTC to present, with a time resolution of 1 hour.
Variables
Name | Description |
---|---|
asngrd | Wind gusts in meters per second (m.s-1) at the surface |
bldgrd | Type of precipitation in codes ({-9.; 1.}) |
c_sigfr | Fraction of significant clouds (0-1) |
grd2t | 3 hours precipitation in millimeters (mm) |
hcc | High cloud cover in fraction (0-1) |
lcc | Low cloud cover in fraction (0-1) |
mcc | Medium cloud cover in fraction (0-1) |
mn2t24grd | Relative humidity in percents (%) at the surface |
p71.129 | Total cloud cover in fraction (0-1) |
p78.129 | Cloud base of significant clouds in meters (m) |
p79.129 | Cloud top of significant clouds at the surface in meters (m) |
rsngrd | U-component of wind in meters per second (m.s-1) at the surface |
sfgrd | Snowfall (convective and stratiform) gradient in meters (m) of water equivalent |
sshfgrd | Sort of precipitation in codes ([1,6]) |
sstkgrd | V-component of wind in meters per second (m.s-1) at the surface |
strdgrd | 1 hour fresh snow cover in centimeters (cm) |
strfgrd | Pressure reduced to mean sea level in Pascals (Pa) |
udvwgrd | Temperature in Kelvins (K) at the surface |
ugrd10 | 1 hour precipitation in millimeters (mm) |
vdvwgrd | Wet bulb temperature in Kelvins (K) |
vis | Visibility in meters (m) at the surface |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from udvwgrd |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) derived from rsngrd and sstkgrd |
WindDirection | Wind direction at 10m in degrees (°) derived from rsngrd and sstkgrd |
CloudCover | Cloud cover fraction (0-1) derived from p71.129 |
RelativeHumidity | Relative humidity at 2m in percents (%) derived from mn2t24grd |
PressureReducedMSL | Pressure at mean sea level pressure in Pascals (Pa) derived from strfgrd |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from ugrd10 |
Dimensions
Name | Description |
---|---|
latitude | -90.0°N to 90.0°N of ~0.25° |
longitude | 0.0°E to 359.75°E with a resolution of ~0.25° |
HRES, historical (ECMWF), identifier: ECMWF_HRES
Example call for ECMWF_HRES, historical forecasts:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/point/historical"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_HRES',
'forecast-horizon': 'full',
'reference-time-freq': '12H',
'start-date': '2023-08-01',
'end-date': '2023-08-04',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed:10, Temperature'
}
response = requests.get(url, headers=headers, params=params)
ECMWF's high resolution 10-day forecast model (documentation).
Geographical coverage and resolution: latitudes -90 to 90°N, longitudes 0 to 360°E with 0.1° step in both directions
Time range and run times: from 2019-01-01 00:00 UTC to 14 days ago. The model is ran every 12 hours (00, 12 UTC). Access to the latest ECMWF_HRES forecast, without 14 day delay, requires an additional agreement with us. If you need it, contact us at support@rebase.energy. See #ECMWF_HRES_OPERATIONAL and #ECMWF_HRES_MIX models.
Forecast horizon and resolution: 10 days horizon for all runs: 91 hourly steps, 18 with 3 hours resolution and 16 with 6 hours resolution.
Variables
The latest forecast is only accessible if you have an additional agreement with us. All the variables below are available historically, but only those marked as latest are available for the latest forecast.
Name | Availability | Description |
---|---|---|
u10 | Hist + Oper | U-component of wind in meters per second (m.s-2) at 10 meters above the surface (GRIB variable documentation) |
v10 | Hist + Oper | V-component of wind in meters per second (m.s-2) at 10 meters above the surface (GRIB variable documentation) |
u100 | Hist + Oper | U-component of wind in meters per second (m.s-2) at 100 meters above the surface (GRIB variable documentation) |
v100 | Hist + Oper | V-component of wind in meters per second (m.s-2) at 100 meters above the surface (GRIB variable documentation) |
u200 | Hist | U-component of wind in meters per second (m.s-2) at 200 meters above the surface (GRIB variable documentation) |
v200 | Hist | V-component of wind in meters per second (m.s-2) at 200 meters above the surface (GRIB variable documentation) |
i10fg | Hist + Oper | Instantaneous wind gusts in meters per second (m.s-1) at 10 meters above the surface (GRIB variable documentation) |
t2m | Hist + Oper | Temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
d2m | Hist + Oper | Dewpoint temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
tav300 | Hist | Average potential temperature in degrees Celsius (°C) in the upper 300m (GRIB variable documentation) |
msl | Hist + Oper | Mean sea level pressure in Pascals (Pa) (GRIB variable documentation) |
tcc | Hist + Oper | Total cloud cover in proportion (0-1) (GRIB variable documentation) |
lcc | Hist | Low cloud cover in proportion (0-1) (GRIB variable documentation) |
mcc | Hist | Medium cloud cover in proportion (0-1) (GRIB variable documentation) |
hcc | Hist | High cloud cover in proportion (0-1) (GRIB variable documentation) |
dsrp | Hist + Oper | Direct solar radiation in Joules per square meter (J.m-2) (GRIB variable documentation) |
ssrd | Hist + Oper | Surface solar radiation downwards in Joules per square meter (J.m-2) (GRIB variable documentation) |
uvb | Hist | Downward UV radiation in Joules per square meter (J.m-2) at the surface (GRIB variable documentation) |
tp | Hist + Oper | Total precipitation in meters (m) (GRIB variable documentation) |
ilspf | Hist | Instantaneous large-scale surface precipitation fraction (GRIB variable documentation) |
Post-processed variables
Name | Availability | Description |
---|---|---|
Temperature | Hist + Oper | Temperature at 2m in degrees Celsius (°C) derived from t2m |
WindSpeed | Hist + Oper | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Hist + Oper | Wind direction at 10m in degrees (°) derived from u10 and v10 |
WindSpeed:100 | Hist + Oper | Wind speed at 100m in meters per second (m.s-1) derived from u100 and v100 |
WindDirection:100 | Hist + Oper | Wind direction at 100m in degrees (°) derived from u100 and v100 |
CloudCover | Hist + Oper | Cloud cover fraction (0-1) derived from tcc |
RelativeHumidity | Hist + Oper | Relative humidity at 2m in percents (%) derived from t2m and d2m |
PressureReducedMSL | Hist + Oper | Pressure at mean sea level pressure in Pascals (Pa) derived from msl |
SolarDownwardRadiation | Hist + Oper | Surface solar radiation in Watts per square meter (W.m-2) derived from ssrd |
TotalPrecipitation | Hist + Oper | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | -90°N to 90°N with a resolution of 0.1° |
longitude | 0°E to 360°E with a resolution of 0.1° |
HRES-Oper (ECMWF), identifier: ECMWF_HRES_OPERATIONAL
Example call for ECMWF_HRES_OPERATIONAL, latest forecasts:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/point/operational"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_HRES_OPERATIONAL',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed:10, Temperature'
}
response = requests.get(url, headers=headers, params=params)
Example call for ECMWF_HRES_OPERATIONAL, historical forecasts:
import requests
url = "https://api.rebase.energy/weather/v2/point/historical"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_HRES_OPERATIONAL',
'forecast-horizon': 'full',
'reference-time-freq': '12H',
'start-date': '2023-08-01',
'end-date': '2023-08-04',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed:10, Temperature'
}
response = requests.get(url, headers=headers, params=params)
ECMWF's high resolution 10-day forecast model, operational (documentation).
Geographical coverage and resolution: latitudes -90 to 90°N, longitudes 0 to 360°E with 0.1° step in both directions
Time range and run times: from the coordinate registration time to present. Access to the latest ECMWF_HRES_OPERATIONAL forecast requires prior point coordinates registration on our dashboard. Contact us at support@rebase.energy
Forecast horizon and resolution: 10 days horizon for all runs: 240 hourly steps.
Variables
The latest forecast is only accessible if you have an additional agreement with us.
Name | Availability | Description |
---|---|---|
u10 | Oper | U-component of wind in meters per second (m.s-2) at 10 meters above the surface (GRIB variable documentation) |
v10 | Oper | V-component of wind in meters per second (m.s-2) at 10 meters above the surface (GRIB variable documentation) |
u100 | Oper | U-component of wind in meters per second (m.s-2) at 100 meters above the surface (GRIB variable documentation) |
v100 | Oper | V-component of wind in meters per second (m.s-2) at 100 meters above the surface (GRIB variable documentation) |
i10fg | Oper | |
t2m | Oper | Temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
d2m | Oper | Dewpoint temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
msl | Oper | Mean sea level pressure in Pascals (Pa) (GRIB variable documentation) |
tcc | Oper | Total cloud cover in proportion (0-1) (GRIB variable documentation) |
dsrp | Oper | Direct solar radiation in Joules per square meter (J.m-2) (GRIB variable documentation) |
ssrd | Oper | Surface solar radiation downwards in Joules per square meter (J.m-2) (GRIB variable documentation) |
Post-processed variables
Name | Availability | Description |
---|---|---|
Temperature | Hist + Oper | Temperature at 2m in degrees Celsius (°C) derived from t2m |
WindSpeed | Hist + Oper | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Hist + Oper | Wind direction at 10m in degrees (°) derived from u10 and v10 |
WindSpeed:100 | Hist + Oper | Wind speed at 100m in meters per second (m.s-1) derived from u100 and v100 |
WindDirection:100 | Hist + Oper | Wind direction at 100m in degrees (°) derived from u100 and v100 |
CloudCover | Hist + Oper | Cloud cover fraction (0-1) derived from tcc |
RelativeHumidity | Hist + Oper | Relative humidity at 2m in percents (%) derived from t2m and d2m |
PressureReducedMSL | Hist + Oper | Pressure at mean sea level pressure in Pascals (Pa) derived from msl |
SolarDownwardRadiation | Hist + Oper | Surface solar radiation in Watts per square meter (W.m-2) derived from ssrd |
TotalPrecipitation | Hist + Oper | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | -90°N to 90°N with a resolution of 0.1° |
longitude | 0°E to 360°E with a resolution of 0.1° |
HRES-Mix (ECMWF), identifier: ECMWF_HRES_MIX
The ECMWF_HRES_MIX is a blend between the ECMWF_HRES historical and ECMWF_HRES_OPERATIONAL models and returns all ECMWF high resolution model runs up to date. The points coordinates have to be registered via the dashboard.
Example call for ECMWF_HRES_MIX, latest forecasts:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/point/operational"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_HRES_MIX',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed:10, Temperature'
}
response = requests.get(url, headers=headers, params=params)
Example call for ECMWF_HRES_MIX, historical forecasts:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/point/historical"
headers = {"Authorization": your_api_key}
params = {
'model': 'ECMWF_HRES_MIX',
'forecast-horizon': 'full',
'reference-time-freq': '12H',
'start-date': '2023-08-01',
'end-date': '2023-08-04',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed:10, Temperature'
}
response = requests.get(url, headers=headers, params=params)
ECMWF's high resolution 10-day forecast model (documentation).
Geographical coverage and resolution: latitudes -90 to 90°N, longitudes 0 to 360°E with 0.1° step in both directions
Time range and run times: from 2019-01-01 00:00 UTC to to 14 days ago. The model is ran every 12 hours (00, 12 UTC). Access to the latest ECMWF_HRES_OPERATIONAL forecast requires prior point coordinates registration on the dashboard. Contact us at support@rebase.energy
Forecast horizon and resolution: 10 days horizon for all runs: 240 hourly steps.
Variables
The latest forecast is only accessible if you have an additional agreement with us. All the variables below are available historically, but only those marked as latest are available for the latest forecast.
Name | Availability | Description |
---|---|---|
u10 | Hist + Oper | U-component of wind in meters per second (m.s-2) at 10 meters above the surface (GRIB variable documentation) |
v10 | Hist + Oper | V-component of wind in meters per second (m.s-2) at 10 meters above the surface (GRIB variable documentation) |
u100 | Hist + Oper | U-component of wind in meters per second (m.s-2) at 100 meters above the surface (GRIB variable documentation) |
v100 | Hist + Oper | V-component of wind in meters per second (m.s-2) at 100 meters above the surface (GRIB variable documentation) |
t2m | Hist + Oper | Temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
d2m | Hist + Oper | Dewpoint temperature in Kelvins (K) at 2 meters above the surface (GRIB variable documentation) |
msl | Hist + Oper | Mean sea level pressure in Pascals (Pa) (GRIB variable documentation) |
tcc | Hist + Oper | Total cloud cover in proportion (0-1) (GRIB variable documentation) |
dsrp | Hist + Oper | Direct solar radiation in Joules per square meter (J.m-2) (GRIB variable documentation) |
ssrd | Hist + Oper | Surface solar radiation downwards in Joules per square meter (J.m-2) (GRIB variable documentation) |
Post-processed variables
Name | Availability | Description |
---|---|---|
Temperature | Hist + Oper | Temperature at 2m in degrees Celsius (°C) derived from t2m |
WindSpeed | Hist + Oper | Wind speed at 10m in meters per second (m.s-1) derived from u10 and v10 |
WindDirection | Hist + Oper | Wind direction at 10m in degrees (°) derived from u10 and v10 |
WindSpeed:100 | Hist + Oper | Wind speed at 100m in meters per second (m.s-1) derived from u100 and v100 |
WindDirection:100 | Hist + Oper | Wind direction at 100m in degrees (°) derived from u100 and v100 |
CloudCover | Hist + Oper | Cloud cover fraction (0-1) derived from tcc |
RelativeHumidity | Hist + Oper | Relative humidity at 2m in percents (%) derived from t2m and d2m |
PressureReducedMSL | Hist + Oper | Pressure at mean sea level pressure in Pascals (Pa) derived from msl |
SolarDownwardRadiation | Hist + Oper | Surface solar radiation in Watts per square meter (W.m-2) derived from ssrd |
TotalPrecipitation | Hist + Oper | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | -90°N to 90°N with a resolution of 0.1° |
longitude | 0°E to 360°E with a resolution of 0.1° |
GlobalHiRes (MetOffice), identifier: MetOffice_GlobalHiRes
Example call for MetOffice_GlobalHiRes:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'MetOffice_GlobalHiRes',
'start-date': '2023-08-01',
'end-date': '2023-08-05',
'reference-time-freq': '6H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'SolarDownwardRadiation, Temperature'
}
response = requests.get(url, headers=headers, params=params)
Global configuration of UK MetOffice's Unified Model (documentation).
Geographical coverage and resolution: latitudes -90 to 90°N, longitudes -180 to 180°E with ~0.09° step in latitude and ~0.14 in longitude
Time range and run times: from 2020-09-24 00:00 UTC to present. The model is ran every 6 hours (00, 06, 12 and 18 UTC). //:
- Forecast horizon and resolution: 84 hours horizon for runs 00 and 12: 54 hourly steps, 30 with 3 hours resolution. 54 hours horizon for runs 06 and 18: 54 hourly steps.
Variables
Name | Description |
---|---|
cc | Total cloud cover in fraction (0-1) (GRIB variable documentation) |
vis | Visibility in meters (m) at 1.5 meters above the ground (GRIB variable documentation) |
r2 | Relative humidity in percents (%) at 2 meters above the ground(GRIB variable documentation) |
prmsl | Pressure in Pascals (Pa) at mean sea level (GRIB variable documentation) |
tprate | Total precipitation rate in kilos per square meter per second (kg.m-2.s-1) (GRIB variable documentation) |
sd | Snow depth water equivalent in kilos per square meter (kg.m-2) (GRIB variable documentation) |
difswrf | Diffuse shortwave radiation flux in Watts per square meter (W.m-2) (GRIB variable documentation) |
dirswrf | Direct shortwave radiation flux in Watts per square meter (W.m-2) (GRIB variable documentation) |
t2m | Temperature in Kelvins (K) at 1.5 meters above the ground (GRIB variable documentation) |
ws | Wind speed in meters per second (m.s-1) at different heights (GRIB variable documentation) |
wdir | Direction from which the wind blows in degrees true (°) at different heights (GRIB variable documentation) |
gust | Wind speed (gust) in meters per second (m.s-1) (GRIB variable documentation). |
lcc | Low cloud cover in percentage (0-100), available between 2020-10-14 to 2021-09-01 and 2023-08-02 to present (GRIB variable documentation) |
hcc | High cloud cover in percentage (0-100), available between 2020-10-14 to 2021-09-01 and 2023-08-02 to present (GRIB variable documentation) |
mcc | Medium cloud cover in percentage (0-100), available between 2020-10-14 to 2021-09-01 and 2023-08-02 to present (GRIB variable documentation) |
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) derived from t2m |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) same as ws:10 |
WindDirection | Wind direction at 10m in degrees (°) same as wdir:10 |
WindSpeed:100 | Wind speed at 100m in meters per second (m.s-1) same as ws:100 |
WindDirection:100 | Wind direction at 100m in degrees (°) same as wdir:100 |
CloudCover | Cloud cover fraction (0-1) same as tcc |
RelativeHumidity | Relative humidity at 2m in percents (%) same as r2 |
PressureReducedMSL | Pressure at mean sea level pressure in Pascals (Pa) same as prmsl |
SolarDownwardRadiation | Surface solar radiation in Watts per square meter (W.m-2) derived from dirswrf and difswrf |
TotalPrecipitation | Surface total precipitation (kg.m-2) derived from tp |
Dimensions
Name | Description |
---|---|
latitude | -90°N to 90°N with a resolution of ~0.09° |
longitude | -180°E to 180°E with a resolution of ~0.14° |
heightAboveGround | Height above the grounds in meters in the ensemble {10; 100} |
Rebase_AI (Graphcast based), identifier: Rebase_AI
Example call for Rebase_AI:
import requests
your_api_key = '' # insert your API key here
url = "https://api.rebase.energy/weather/v2/query"
headers = {"Authorization": your_api_key}
params = {
'model': 'Rebase_AI',
'start-date': '2023-01-01',
'end-date': '2023-01-05',
'reference-time-freq': '24H',
'forecast-horizon': 'full',
'latitude': '60.1, 61.2, 59.33',
'longitude': '17.2, 13.1, 18.05',
'variables': 'WindSpeed, Temperature'
}
response = requests.get(url, headers=headers, params=params)
Rebase AI configuration for Google DeepMind's Graphcast deep neural network learning model (documentation).
Geographical coverage and resolution: latitudes -90 to 90°N, longitudes -180 to 180°E with 0.25° step.
Time range and run times: from 2023-01-01 00:00 UTC to present. The model is ran every 6 hours (00, 06, 12 and 18 UTC).
- Forecast horizon and resolution: 168 hours horizon for runs 00 and 12: 96 hourly steps and 72 with 3 hours resolution.
Post-processed variables
Name | Description |
---|---|
Temperature | Temperature at 2m in degrees Celsius (°C) |
WindSpeed | Wind speed at 10m in meters per second (m.s-1) |
WindDirection | Wind direction at 10m in degrees (°) |
RelativeHumidity | Relative humidity at 2m in percents (%) |
PressureReducedMSL | Pressure at mean sea level pressure in Pascals (Pa) |
TotalPrecipitation | Surface total precipitation (kg.m-2) |
Dimensions
Name | Description |
---|---|
latitude | -90°N to 90°N with a resolution of 0.25° |
longitude | -180°E to 180°E with a resolution of 0.25° |
Policies
By using the Weather API, you agree to our terms of service. Please take a moment to review the terms.
Rebase Energy reserves the right to suspend or terminate accounts that violate our policies.
Errors
The Weather API uses the following error codes:
Error Code | Meaning |
---|---|
400 | Bad Request -- Your request is invalid. |
401 | Unauthorized -- Your API key is invalid. |
403 | Forbidden -- You do not have sufficient rights to access this data. |
404 | Not Found -- The specified data could not be found. |
405 | Method Not Allowed -- You tried to access a dataset with an invalid method. |
406 | Not Acceptable -- You requested a format that is not json. |
410 | Gone -- The dataset requested has been removed from our servers. |
418 | I'm a teapot. 🙃 |
429 | Too Many Requests -- You're exceeding our rate policies |
500 | Internal Server Error -- We had a problem with our server. Please try again later. |
503 | Service Unavailable -- The service is not available at the moment. Please try again later. |