Forecast API Configurator

note

The following page explains the Forecast API configurator page of the meteoblue API+ product. It can be accessed here. In order to create functional API requests, a valid API key is required.

The interactive Forecast API configurator allows users to quickly select desired forecast packages and configure an API call. All packages are listed here. To query data these simple steps are required:

Select location through location search bar
Select API key and unit settings
Select API packages
Use generated API URL to receive data

Location Search Bar

The location can be selected by using the location search bar at the top of the page. Any location worldwide can be searched for. The coordinates of the last location used are then implemented into the API call. The elevation of the location will be automatically filled with a digital elevation model, if no other elevation is specified.

Settings Panel

Time Zone

Users can select any local time zone according to the technical documentation in the settings panel. If no time zone is chosen, the API will detect the time zone automatically. For coordinates on sea, the API tries to find a time zone close to shore (approximately up to 50 km), otherwise GMT is used.

Units

Different units for temperature, wind speed, wind direction and precipitation can be selected. Per default Celsius, kilometers per hour, millimeter and degree are defined.

Users can switch to Fahrenheit for temperature; meters per second, miles per hour, knoten, and the beaufort scale for wind speed; inches for precipitation, and different formats for wind direction.

Forecast length and history length

With the meteoblue Forecast API, forecast weather data for up to 7 days and historical forecast data for up to 4 days can be retrieved. Users can select the desired time period by changing the forecast and history length.

Note that the historical data, which can be delivered by the forecast API, includes different postprocessing levels as described in the documentation.

Formats

API+ offers different output formats like CSV and JSON. Please note that CSV is only available for similar time intervals. To retrieve data from multiple packages with different time intervals, multiple API calls have to be effectuated.

CSV

CSV can be used to download and open the result in Microsoft Excel and many other applications. The format is limited in a way, it supports structured data or multi-dimensional data.

JSON

JSON format is preferred to integrate the API into other systems. It resembles closely how data are processed internally and is efficient to transfer.

API Packages Available in API+

warning

History packages and specific forecast packages not listed here (e.g. renewable energy or upper atmosphere packages) as well as images are not part of API+.
In order to get access to these features, a higher meteoblue access level is required. More information about this can be found on our product pages.

For detailed documentation and example API calls for all packages, see the Package API Documentation, also linked directly in the following for every specific package included in API+.

One API call can include several packages. Each package is accounted individually, but the unique design of the Package API allows you to combine multiple packages into one HTTP API call.

General Forecast Packages

General Packages	Time Resolution
Basic	15min, 1h, 3h, day
Current
Clouds	1h, 3h, day
Sun and moon

Agronomical Packages

Agronomical Packages	Time Resolution
Agro	1h, 3h, day
Agromodel Leaf Wetness	1h
Agromodel Sowing	1h, day
Agromodel Spray	1h, day

Renewable Energy Packages

Renewable Energy Packages	Time Resolution
Solar	15min, 1h, 3h, day
Solar Ensemble	1h
Wind	15min, 1h, 3h, day
Wind 80m Ensemble	1h

Advanced Packages

Advanced Packages	Time Resolution
Sea	1h, 3h, day
Air	1h, 3h, day
Air Quality	1h, 3h, day

Multimodel Packages

Multimodel Packages	Time Resolution
Multimodel	1h
Multimodel Temperature	1h
Multimodel Precipitation	1h
Multimodel Relative Humidity	1h
Multimodel Wind	1h
Multimodel Wind 80m	1h
Multimodel Clouds	1h
Multimodel Radiation	1h

14-Day Forecast Packages

14-day Forecast Packages	Time Resolution
Trend	1h, day
Trend Pro	1h, day
Ensemble	1h