get_metno_forecast: Get Weather Forecast Data from MET Weather API

In weatherOz: An API Client for Australian Weather and Climate Data Resources

Get Weather Forecast Data from MET Weather API

Description

Retrieves weather forecast data from the Norwegian Meteorological Institute locationforecast API and returns the parsed metadata together with a tidy hourly data.table. The response headers Expires and Last-Modified are provided both in their raw RFC 1123 form and parsed to POSIXct for downstream logic.

Usage

get_metno_forecast(
  latitude,
  longitude,
  format = c("compact", "complete"),
  api_key = get_key(service = "METNO"),
  timeout = 30,
  max_retries = 3,
  retry_delay = 1,
  use_cache = TRUE,
  cache_dir = NULL,
  allow_stale_on_error = TRUE
)

Arguments

latitude	Numeric. Latitude in decimal degrees for the forecast location. Must be within Australian limits (-44 to -10).
longitude	Numeric. Longitude in decimal degrees for the forecast location. Must be within Australian limits (112 to 154).
format	Character. Either "compact" (default) or "complete" for the MET Weather API locationforecast endpoint variant.
api_key	Character. Email address required for the User-Agent header in accordance with MET Weather API terms of service.
timeout	Numeric. Request timeout in seconds (default: 30).
max_retries	Integer. Maximum number of retry attempts on transient failures (default: 3).
retry_delay	Numeric. Base delay between retries in seconds for exponential backoff (default: 1).
use_cache	Logical. Use session-scoped cache and conditional revalidation for MET.NO responses. Defaults to TRUE.
cache_dir	Character. Optional directory path for cache files. If NULL (default), uses file.path(tempdir(), "metno_cache").
allow_stale_on_error	Logical. If TRUE (default), return stale cached data when MET.NO returns HTTP 429 (rate limit exceeded) and stale cache is available.

Value

A named list with elements:

data

Hourly forecast as a data.table.

raw

The full parsed GeoJSON response (list).

metadata

A list containing request parameters, status code, retrieval timestamp, header information (expires_raw, expires, last_modified_raw, last_modified), and cache provenance in metadata$cache.

Author(s)

Rodrigo Pires, [e-mail]

See Also

Other METNO: get_metno_daily_forecast(), metno_get_dominant_symbol(), metno_resample_data_table(), metno_timeseries_to_data_table()

Other data fetching: get_coastal_forecast(), get_data_drill(), get_data_drill_apsim(), get_dpird_apsim(), get_dpird_extremes(), get_dpird_minute(), get_dpird_summaries(), get_metno_daily_forecast(), get_patched_point(), get_patched_point_apsim(), get_precis_forecast(), get_radar_imagery(), get_satellite_imagery()

Examples

## Not run: 
forecast <- get_metno_forecast(
  latitude = -31.95,
  longitude = 115.86,
  api_key = "[e-mail]"
)
forecast$metadata$expires
utils::head(forecast$data)

## End(Not run)

weatherOz documentation built on April 8, 2026, 9:09 a.m.