Forecast API Configurator
The following page explains the Forecast API configurator page of the meteoblue Weather API . 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:
- Specify location
- Select API key and unit settings
- Select API packages
- Use generated API URL to receive data
Specify Location
The location is specified by geographic coordinates with latitude and longitude, which can be retrieved with the location search API. The elevation above sea level is optional and if omitted, the API will use a digital elevation model to autodetect the elevation with high accuracy. You can also set the location by going to our homepage and typing the cityname or zipcode in the location search bar. The coordinates of the last location used are then implemented into the API call.
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
Free Weather 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 or JSON format can be applied.
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.
Packages Available in Free Weather 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 Free Weather 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 Forecast API Documentation, also linked directly in the following for every specific package included in the Free Weather API.
One API call can include several packages. Each package is accounted individually, but the unique design of the Forecast 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 |