The following step by step instructions will configure a weather forecast API for your needs. Additional information is 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 "Cambridge" is selected and the generated API URL will use the WGS84 coordinates with latitude (&lat=42.38) and longitude (&lon=-71.11). To change the location, use the location search at the top of the page. The elevation above sea level (&asl=5) 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 Forecast Packages

Basic: For general purposes, contains the most common weather variables

Current: Current weather information, including observations and measurements

Clouds: Detailed cloud layer and sunshine duration forecasts

Sun and Moon: Information about rising and setting times of sun and moon

Basic

For general purposes, contains the most common weather variables

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

Current weather information, including observations and measurements

Weather variables:

  • Temperature
  • Wind speed
  • Pictocode

Clouds

Detailed cloud layer and sunshine duration forecasts

Weather variables:

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

Sun and Moon

Information about rising and setting times of 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: For agricultural purposes, contains soil and vegetation related weather variables

Agromodel Leaf Wetness: Relevant information for monitoring and forecasting leaf wetness

Agromodel Sowing: Information about suitable time windows for sowing crops

Agromodel Spray: Information about suitable time windows for spaying fields

Agro

For agricultural purposes, contains soil and vegetation related weather variables

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

Relevant information for monitoring and forecasting leaf wetness

Weather variables:

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

Agromodel Sowing

Information about suitable time windows for sowing crops

Weather variables:

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

Agromodel Spray

Information about suitable time windows for spaying fields

Weather variables:

  • Spray window

Renewable Energy Packages

Solar: Specific solar radiation variables for the solar energy sector

Solar Ensemble: Aggregated and individual members from the GFS ensemble solar forecast

Wind: Specific wind variables for the wind energy sector

Wind 80m Ensemble: Aggregated and individual members from the GFS ensemble wind forecast

Solar

Specific solar radiation variables for the solar energy sector

Weather variables:

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

Solar Ensemble

Aggregated and individual members from the GFS ensemble solar forecast

Weather variables:

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

Wind

Specific wind variables for the wind energy sector

Weather variables:

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

Wind 80m Ensemble

Aggregated and individual members from the GFS ensemble wind forecast

Weather variables:

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

Advanced Packages

Sea: Marine weather forecasts

Air: Atmospheric forecasts like CAPE and Lifted Index

Air Quality: Air quality forecast like pollutant concentrations

Sea

Marine weather forecasts

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

Atmospheric forecasts like CAPE and Lifted Index

Weather variables:

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

Air Quality

Air quality forecast like pollutant 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: Raw model output for all models available for the selected location

Multimodel

Raw model output for all models available for the selected location

Weather variables:

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

14-day Forecast Packages

Trend / Trend Pro: 14-day ensemble forecasts for the most common weather variables. Trend Pro offers additonal variables

Ensemble: Individual members of the GFS ensemble forecast

Trend / Trend Pro

14-day ensemble forecasts for the most common weather variables. 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

Individual members of the 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 Cambridge 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
Back to top