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.
Forecast API Access Levels
The Forecast API configurator displays available packages depending on the access level of the user. Free Weather API users can access a limited selection of Forecast API packages, while higher access levels provide additional packages for specialised use cases such as renewable energy, agriculture, aviation, marine weather, multimodel comparison, and extended-range forecasting.
More information about all available packages can be found on our Forecast API documentation.
Packages Included in Free Weather API
Free Weather API includes access to selected Forecast API packages only. Forecast packages not listed here require a higher meteoblue access level. Free Weather API users also have full access to meteograms through the Image API.
More information about meteoblue API products can be found on our product pages.
For detailed documentation and example API calls for available packages, see the Forecast API Documentation.
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.