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.
Forecast API Configurator
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.
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.
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.
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 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 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+
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|
|Clouds||1h, 3h, day|
|Sun and moon|
|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|
|Wind||15min, 1h, 3h, day|
|Wind 80m Ensemble||1h|
|Advanced Packages||Time Resolution|
|Sea||1h, 3h, day|
|Air||1h, 3h, day|
|Air Quality||1h, 3h, day|
|Multimodel Packages||Time Resolution|
|Multimodel Relative Humidity||1h|
|Multimodel Wind 80m||1h|
14-Day Forecast Packages
|14-day Forecast Packages||Time Resolution|
|Trend Pro||1h, day|