The following step by step instructions will configure a weather forecast API for your needs. Additional information is also available in our technical documentation. If you have any questions, do not hesitate to contact us at support@meteoblue.com.

1. Select API Key and Settings

All API calls will be authorized using API keys. With API+ you can configure your API keys on the API key management page.

Customisable API settings: time zone, data format, weather variable units, and forecast time span.

Settings

2. Select location

The location "Ashburn" is selected and the generated API URL will use the WGS84 coordinates with latitude (&lat=39.04) and longitude (&lon=-77.49). To change the location, use the location search at the top of the page. The elevation above sea level (&asl=90) is optional and if omitted, the API will use a digital elevation model.

3. Select API packages

Weather variables are clustered into data packages. The API packages can be further combined according to your preference, as one API call may deliver several data packages. You will not be charged for the individual API calls but for the amount of meteoblue credits you use.

General Packages

Basic: Most common weather variables with constant updates to improve forecast quality

Current: Returns the current temperature and wind speed

Sun and Moon: Information about the sun and moon

Basic

Most common weather variables with constant updates to improve forecast quality

Weather variables:

  • Temperature
  • Snow fraction
  • Wind speed and direction
  • Relative humidity
  • Sea level pressure
  • Pictocode
  • Convective precipitation
  • Apparent temperature
  • Precipitation amount and probability
  • rainSPOT

Current

Returns the current temperature and wind speed

Weather variables:

  • Temperature
  • Wind speed
  • Pictocode

Sun and Moon

Information about the sun and moon

Weather variables:

  • Sunrise and sunset time
  • Moon rise and moon set time
  • Moon phase angle and name
  • Moon age
  • Moon phase transit time

Agronomical Packages

Agro: Weather variables for field and crop management

Agromodel Leaf Wetness: Leaf wetness probability and calibration indices

Agromodel Sowing: Sowing information for different crops

Agromodel Spray: Information about the suitability to spray

Agro

Weather variables for field and crop management

Weather variables:

  • Surface, dewpoint and wetbulb temperature
  • Total, potential and ET0 reference evapotranspiration
  • Leaf wetness index
  • Soil temperature and moisture
  • Mean sensible heat flux

Agromodel Leaf Wetness

Leaf wetness probability and calibration indices

Weather variables:

  • Leaf wetness rain index
  • Leaf wetness dew index
  • Leaf wetness probability
  • Leaf wetness evaporation index

Agromodel Sowing

Sowing information for different crops

Weather variables:

  • Available crops: maize, wheat, barley, rapeseed, potato, sugarbeets, soybean, cotton, riceindica, ricejaponi, sorghum

Agromodel Spray

Information about the suitability to spray

Weather variables:

  • Spray window

Renewable Energy Packages

Solar: High accuracy solar irradiance forecast

Solar Ensemble: Solar forecast from over 25 different GFS ensemble members

Wind: Wind gusts and wind at 80 meter above ground

Wind 80m Ensemble: Wind forecast from over 25 different GFS ensemble members

Solar

High accuracy solar irradiance forecast

Weather variables:

  • Global horizontal irradiance (GHI)
  • Diffuse radiation (DIF)
  • Direct normal irradiance (DNI)
  • Global normal irradiance (GNI)
  • Extraterrestrial solar radiation

Solar Ensemble

Solar forecast from over 25 different GFS ensemble members

Weather variables:

  • Max GHI backwards
  • Min GHI backwards
  • GHI backwards consensus
  • GHI backwards p90 exceedence

Wind

Wind gusts and wind at 80 meter above ground

Weather variables:

  • Wind gusts at 10m
  • Wind direction at 80m
  • Wind speed at 80m
  • Air density
  • Air pressure

Wind 80m Ensemble

Wind forecast from over 25 different GFS ensemble members

Weather variables:

  • Wind speed 80m consensus
  • Wind speed 80m p90 exceedence
  • Min and max wind speed 80m

Advanced Packages

Clouds: Multi-layer cloud and visibility forecast

Sea: Wave and ocean currents forecast. Sea data are only available for locations located at least 20km away from the coast

Air: Specific weather variables for aviation

Air Quality: Air quality index, particle matter, gases and pollen concentrations

Clouds

Multi-layer cloud and visibility forecast

Weather variables:

  • Visibility
  • Sunshine time
  • Low, medium, high, total cloud cover

Sea

Wave and ocean currents forecast. Sea data are only available for locations located at least 20km away from the coast

Weather variables:

  • Significant height, mean period, peak wave period of swell waves
  • Wind wave height, direction and peak waves
  • Sea surface temperature
  • Mean wind wave period
  • Mean wave period and direction
  • Current velocity U and V
  • Significant wave height

Air

Specific weather variables for aviation

Weather variables:

  • CAPE
  • Lifted index
  • Boundary layer height
  • Helicity
  • Convective inhibition
  • Cloud water and ice
  • Freezing level height

Air Quality

Air quality index, particle matter, gases and pollen concentrations

Weather variables:

  • Air quality index
  • Birch, grass, olive pollen
  • PM2.5, PM10
  • SO2, NO2, CO
  • Ozone, dust and AOD500 concentration
  • Sandstorm alert

Multimodel Packages

Multimodel: Forecast from multiple independent weather models

Single Variable Multimodel: Forecast from multiple independent weather models for selectable variables

Multimodel

Forecast from multiple independent weather models

Weather variables:

  • Temperature
  • Wind speed and direction
  • Precipitation
  • Cloud Cover
  • Temperature and wind speed with spread
  • Shortwave radiation (GHI)

Single Variable Multimodel

Forecast from multiple independent weather models for selectable variables

14-day Forecast Packages

Trend / Trend Pro: 14 days weather trend with statistical spreads. Trend Pro offers additonal variables

Ensemble: All individual members of GFS ensemble forecast

Trend / Trend Pro

14 days weather trend with statistical spreads. Trend Pro offers additonal variables

Weather variables:

  • Temperature
  • Precipitation amount
  • Wind speed, direction and gust
  • GHI backwards
  • Temperature, precipitation, cloud cover and wind speed spread
  • Low, medium, high and total cloud cover
More variables
  • CAPE
  • Sea level pressure
  • Relative humidity
  • Snow fraction
  • GHI backwards
  • Pictocode
  • Total, potential and ET0 reference evapotranspiration
  • Extraterrestrial radiation backwards
  • Additionally in trendpro:
  • Gust wind
  • Sunshine time
  • Visibility
  • Surface temperature
  • Dewpoint temperature
  • Lifted index

Ensemble

All individual members of GFS ensemble forecast

Weather variables:

  • Temperature
  • Precipitation
  • Wind speed, direction and gust
  • Surface temperature
  • Low, medium and high cloud cover
  • Global horizontal irradiance (GHI)

Settings

Time zone

The timezone in Ashburn is America/New_York. If no timezone is specified, the API uses a timezone database to find a suitable timezone. Automatic timezone resolution has limited accuracy at timezone boarders and coastal areas.

Format

JSON and CSV can be used as an output format. Note: For CSV only one time interval can be returned, you can not combine different time intervals.

Units
Forecast length (in days)

Optional setting to define the number of forecast days. The API delivers all available forecast time steps per default.

History length (in days)

The API offers up to 4 days of the previous days.

4. Generated API URL

You can now use this API URL to integrate into your application. The API URL is updated automatically as soon as you make changes in this URL configurator.

Each call will deduct 12000 meteoblue credits

Packages selected:

  • basic-1h - 8000 credits
  • basic-day - 4000 credits