get_climate_data
Get climate observations from NOAA Climate Data Online.
Returns historical weather measurements such as temperature, precipitation,
and snowfall. You must provide either a station_id or a FIPS code to
identify the location, and a date range.
Args:
station_id: NOAA station identifier (e.g. 'GHCND:USW00094728' for Central Park).
fips: FIPS code for county or state (e.g. '36' for New York state, '36061' for Manhattan).
dataset: Dataset ID. Common values: 'GHCND' (daily summaries), 'GSOM' (monthly),
'GSOY' (annual), 'NORMAL_DLY' (daily normals). Default is 'GHCND'.
start_date: Start date in YYYY-MM-DD format. Required for most datasets.
end_date: End date in YYYY-MM-DD format. Required for most datasets.
data_types: Comma-separated data type IDs to filter. Common types:
TMAX (max temp), TMIN (min temp), TAVG (avg temp),
PRCP (precipitation), SNOW (snowfall), SNWD (snow depth),
AWND (avg wind speed). If omitted, all available types are returned.
limit: Maximum number of records to return (default 100, max 1000).
find_stations
Find NOAA weather stations in an area.
Returns a list of weather stations with their IDs, names, coordinates,
and active date ranges. Use the station IDs with get_climate_data.
Args:
state: Two-letter US state abbreviation (e.g. 'CA', 'NY').
county_fips: Five-digit county FIPS code (e.g. '36061' for Manhattan).
dataset: Dataset ID to filter stations that have data in this dataset.
Default is 'GHCND' (daily summaries).
limit: Maximum number of stations to return (default 25, max 1000).
get_climate_normals
Get 30-year climate normal values for a NOAA weather station.
Climate normals are averages computed over the most recent 30-year period
(currently 1991-2020). They represent typical conditions for a location
and are useful for comparing current conditions to historical baselines.
Args:
station_id: NOAA station identifier (e.g. 'GHCND:USW00094728').
Use find_stations to look up station IDs.
data_types: Comma-separated normal data type IDs to filter. Common types:
DLY-TMAX-NORMAL (avg daily max temp), DLY-TMIN-NORMAL (avg daily min temp),
DLY-TAVG-NORMAL (avg daily temp), DLY-PRCP-PCTALL-GE001HI (precip probability),
MTD-PRCP-NORMAL (monthly precip), ANN-TMAX-NORMAL (annual max temp).
If omitted, all available normals are returned.