NOAA Climate Data Online: Historical Weather and Climate Data for GIS
NOAA Climate Data Online (CDO) is a public access and discovery system for NOAA’s historical weather and climate records. It provides station-based observations, derived summaries, climate normals, radar-related data, and station metadata that can be searched by location, station, date, dataset, or measurement type. CDO is especially useful for connecting environmental conditions to places: cities, counties, ZIP codes, weather stations, watersheds, transportation corridors, buildings, infrastructure, and other geographic features. It is not a single uniform raster or vector dataset. Instead, it is an access ecosystem whose datasets differ in geography, temporal coverage, measurement type, station density, quality controls, formats, and update behavior.
NOAA Climate Data Online is one of the most useful sources for adding historical atmospheric and climate context to a GIS project. It brings together observations and derived products covering temperature, precipitation, wind, degree days, radar, climate normals, marine observations, and station history. The data is generally organized around observing stations and named datasets rather than around a continuous wall-to-wall map. That distinction matters: CDO can tell you what was observed at or near a location, but it does not automatically provide a complete climate surface for every parcel, road, building, or address. A sound workflow begins by selecting the right dataset, identifying the relevant station or location, checking the period of record and measurement definitions, and then joining the results to geographic features.
How EDK fits
For: GIS analysts, climate researchers, environmental planners, public-sector data teams, developers building weather-aware applications, and anyone combining historical weather or climate indicators with geographic features.
NOAA Climate Data Online relates to the physical-world model perspective through its role as an environmental evidence layer. CDO supplies measurements and derived climate statistics tied to real observing stations, marine platforms, locations, and time periods. Those records can add temporal context to a searchable geographic representation of roads, buildings, infrastructure, waterways, vegetation, public assets, and other physical features. For example, a climate analysis may compare precipitation or temperature histories around a set of buildings, rank infrastructure by exposure to historical heat or freezing conditions, aggregate station observations by region, or examine environmental conditions near transportation and drainage networks. The connection is complementary rather than substitutive: CDO provides climate observations and station metadata, while a broader world model is needed to represent the surrounding physical features and perform cross-layer geographic computation.
- •Join daily, monthly, seasonal, or annual weather summaries to cities, counties, watersheds, roads, buildings, infrastructure, or other geographic features using station coordinates, location identifiers, or spatial proximity.
- •Compute regional climate indicators by filtering CDO observations by date and measurement type, then aggregating values within geographic boundaries or around selected physical assets.
- •Use climate normals as a baseline for comparing typical temperature or precipitation conditions with observed events, environmental changes, construction activity, infrastructure locations, or other location-based signals.
Dataset profile
Formats
JSON through the CDO Web Services API
CSV and text downloads for selected products
PDF summaries and reports for selected products
XML, Shapefile, KMZ, NetCDF, OPeNDAP, and THREDDS through applicable NCEI services
Interactive web maps and browser-based tables
Access methods
CDO interactive search and ordering interface
CDO Web Services API v2 with a free registration token
NOAA NCEI access and search services
NOAA geospatial REST services for applicable station and climatological products
Product-specific downloads and data-service endpoints
Quality and limits
Station density is uneven, and many locations have no direct observations.
The nearest station may be an imperfect substitute for a target address or physical feature.
Station relocations, instrument changes, missing records, and network differences can affect time-series comparisons.
Measurement definitions, units, quality-control procedures, and derived statistics vary by dataset.
Climate Normals describe a standard reference period and are not current observations or forecasts.
API quotas, pagination requirements, and date-range limits can complicate large automated downloads.
A continuous interpolated surface requires additional modeling assumptions and uncertainty analysis.
Analysis workflows
Identify the exact CDO dataset, data type, station network, time period, and unit system required.
Retrieve station and location metadata, including identifiers, coordinates, elevation, network, and period of record.
Query observations by station, date range, dataset, and variable; paginate results and preserve source metadata.
Normalize units, missing values, timestamps, quality flags, and measurement definitions before analysis.
Join station observations to administrative boundaries, watersheds, roads, buildings, infrastructure, environmental features, or custom regions.
Calculate seasonal summaries, anomalies, exceedance counts, trends, degree-day totals, precipitation accumulations, or climate-normal comparisons.
Use spatial proximity or interpolation only after evaluating station representativeness, terrain, network density, and uncertainty.
Record dataset identifiers, retrieval dates, API parameters, station selections, and product versions for reproducibility.
Value inside EDK
What NOAA Climate Data Online contains
NOAA Climate Data Online provides access to historical weather and climate records maintained through NOAA’s National Centers for Environmental Information. The CDO portal describes quality-controlled daily, monthly, seasonal, and yearly measurements of temperature, precipitation, wind, and degree days, along with radar data, station history information, and 30-year Climate Normals. (ncei.noaa.gov)
The system includes several distinct kinds of information. Station-based records can contain observed values and associated measurement types, while derived products summarize conditions over a month, season, year, or standard climatological period. Climate Normals provide statistical descriptions of typical conditions rather than observations from a single day. NOAA’s current U.S. Climate Normals are based on the 1991–2020 period and include annual, seasonal, monthly, daily, and hourly averages and statistics for temperature, precipitation, and other variables. (ncei.noaa.gov)
- •Daily and monthly weather summaries
- •Seasonal and annual climate measurements
- •Temperature, precipitation, wind, degree days, snowfall, and related variables
- •Climate Normals and other derived climatological products
- •Marine observations from ships, buoys, platforms, and coastal stations
- •Station and location metadata, including identifiers and geographic references
- •Radar and other weather-related products available through NOAA access services
Geography, temporal coverage, and update cadence
CDO has global reach, but geographic coverage is not uniform. The portal describes an archive of global historical weather and climate data, while individual datasets and station networks determine where observations actually exist. A city, ZIP code, county, or country search may return associated stations, but the result should not be interpreted as a continuous measurement surface. NOAA’s FAQ explicitly notes that weather is not observed and reported at every location and that the closest available reporting station may need to be used as a substitute. (ncei.noaa.gov)
Temporal coverage also varies by dataset and station. Some records extend back many decades or centuries in selected locations, while other stations have shorter periods of record, gaps, relocations, or changes in instrumentation. The API exposes dataset-level minimum and maximum dates, but analysts still need to inspect station-specific availability and missing values before comparing places or years. The API documentation also restricts date ranges for some requests: annual and monthly data can cover up to ten years in one request, while other data types are limited to one year. (ncei.noaa.gov)
- •Global archive scope, with uneven station density and product coverage
- •Station-specific periods of record rather than one universal time span
- •Different update schedules for observations, summaries, normals, radar, and metadata
- •Historical station moves, instrument changes, missing periods, and network differences can affect comparisons
- •A station observation is not automatically representative of every nearby address or feature
Formats and access methods
The CDO website supports interactive discovery and ordering by station name or identifier, ZIP code, city, county, state, or country. This is useful for exploratory work, but larger or repeatable workflows generally benefit from the API or direct data services. The CDO Web Services API exposes endpoints for datasets, data categories, data types, locations, stations, and data. API responses are JSON, and the data endpoint supports filters for dataset, data type, location, station, date range, units, sorting, pagination, and metadata inclusion. (ncei.noaa.gov)
Programmatic access requires a free registration token. NOAA documents a limit of five requests per second and 10,000 requests per day for each token. Those limits make the API appropriate for targeted extraction, application backends, and moderate-scale analysis, but a large historical pull may require batching, caching, pagination, or another NOAA distribution channel. (ncei.noaa.gov)
- •Interactive CDO search and ordering tools
- •CDO REST API with JSON responses
- •Downloadable CSV, text, and PDF products for selected datasets
- •NOAA geospatial services and map products
- •Broader NCEI services that may expose XML, Shapefile, KMZ, NetCDF, OPeNDAP, or THREDDS access depending on the product
- •Station, location, and dataset metadata for reproducible filtering
Suitable GIS and spatial-analysis workflows
A practical CDO workflow starts with dataset selection rather than map production. First identify whether the analysis needs raw or summarized observations, a daily or monthly time scale, a climate normal, marine data, radar, or another product. Then identify the stations or locations that cover the study area and document their identifiers, coordinates, elevations, network type, and period of record.
For point-based analysis, import station metadata into a GIS as point features and retain the station identifier as the stable join key. Query observations by station and date, normalize units, parse missing-value conventions, and join the resulting table back to the station layer. From there, analysts can calculate time-series statistics, anomalies, exceedance counts, seasonal summaries, or event windows.
- •Select a specific CDO dataset and data type before downloading
- •Create a station or location layer from authoritative NOAA metadata
- •Query by station, date range, dataset, and measurement type
- •Convert units consistently and preserve original values and metadata
- •Join observations to boundaries, assets, roads, buildings, waterways, or infrastructure
- •Calculate summaries, anomalies, thresholds, trends, or exposure indicators
- •Validate station distance, elevation, record completeness, and representativeness
- •Use interpolation only with explicit methodological and uncertainty documentation
License, strengths, and tradeoffs
NOAA states that environmental data and information produced by NOAA or another federal agency are available openly unless specifically exempted, and that such data are in the public domain in the United States. NCEI encourages CC0 treatment for applicable data and also notes that contributed or externally sourced holdings may have different licensing conditions. Users should therefore preserve dataset-level attribution and inspect the metadata for the exact product being redistributed or incorporated into an application. (ncei.noaa.gov)
The main strength of CDO is breadth: it offers a long-running, authoritative archive with multiple temporal scales, station networks, climate statistics, and developer access methods. Its main tradeoff is that the archive is heterogeneous. A workflow that combines daily station observations, climate normals, radar products, and marine records must reconcile different spatial meanings, time bases, quality rules, formats, and update schedules.
- •Strong foundation for historical weather and climate context
- •Authoritative NOAA provenance and extensive documentation
- •Multiple discovery, download, API, and geospatial access paths
- •Global archive with especially rich U.S. station and climate-normal coverage
- •Not a uniform global raster, current forecast service, or complete weather record for every location
- •Station moves, missing values, network changes, and variable definitions require careful validation
- •Dataset-specific formats, date limits, API quotas, and update schedules complicate large-scale automation
Questions teams ask
Is NOAA Climate Data Online one dataset?
No. CDO is a discovery, access, and ordering system for multiple NOAA weather and climate datasets. Daily summaries, monthly and annual products, Climate Normals, marine data, radar-related products, station metadata, and other holdings have different structures and coverage. Select and document the exact dataset and data type used.
Can CDO provide weather data for a specific address?
Usually not as a direct observation. CDO data is commonly tied to observing stations or named locations, and NOAA notes that weather is not observed at every location. A GIS workflow may use the nearest suitable station, a set of nearby stations, or an interpolated surface, but the method and uncertainty should be stated.
How do I access CDO programmatically?
Register for a free CDO API token, then use the version 2 REST endpoints for datasets, stations, locations, data types, and observations. Responses are JSON. The documented token limits are five requests per second and 10,000 requests per day, and requests should be paginated and restricted to the needed date range and variables.
Are NOAA Climate Data Online records free to use?
CDO provides free public access to its data. NOAA states that environmental data produced by NOAA or federal agencies are generally public domain in the United States, while contributed or externally sourced holdings may carry different conditions. Check the metadata for the exact product and retain appropriate attribution.
Keep exploring
global surface water
Global Surface Water provides a complementary environmental layer for comparing historical climate conditions with mapped water occurrence, seasonality, and change.
landsat collection 2
Landsat Collection 2 complements CDO by providing spatially continuous satellite observations for land, vegetation, water, and built-environment change.
copernicus dem
Copernicus DEM adds elevation and surface context that can help interpret station representativeness, terrain effects, watershed conditions, and geographic exposure.
Sources
NOAA Climate Data Online overview
Official CDO description of the archive, major data categories, historical coverage, and discovery tools.
Open sourceClimate Data Online Web Services API v2 documentation
Official documentation for datasets, stations, locations, data queries, JSON responses, tokens, quotas, filters, and date-range constraints.
Open sourceNCEI Web Services directory
Official overview of CDO APIs and broader NCEI GIS, REST, OPeNDAP, THREDDS, and downloadable data services.
Open sourceNOAA U.S. Climate Normals
Official documentation for the 1991–2020 U.S. Climate Normals, their temporal products, station coverage, and decadal production cycle.
Open sourceNCEI Open Data Policy
Official policy describing public access, public-domain treatment for NOAA and federal environmental data, and licensing considerations for contributed holdings.
Open source