导航|地址|刷新
Data API
!doctype html>



Aviation Weather CenterAWC


Aviation Weather Center

National Weather Service
------
Contact UsHelp InformationToggle dark mode
------
AdminSign in





Weather
Observations
------

GFA FORECAST
Ceiling & VisibilityCloudsPrecipitationThunderstormsTemperatureWindsTurbulenceIcing


Products
SIGMETG-AIRMETCenter Weather Adv
------
Prog chartsTAF mapForecast Discussions
------
METAR/TAF dataPIREP/AIREP dataWind/temp dataITWS data
------
WAFS gridsSigWx chartsTCF/eTCF/ECFP


Tools
Terminal Weather DashboardWinter Weather DashboardCeiling & Visibility DashboardPre-Duty Weather BriefingsCWSU StatusAdvanced Map
------
Decision support imageryTraffic Flow Management PortalFax chartsArchive ViewData APIStatus
------
Submit a PIREP
Edit Gate Forecast



Connect


About AWC
------
Recent changesUpcoming changes Outreach
------
SIGMET PreviewTCF WhiteboardAviation Weather Testbed







Sign inSettingsAdmin
------

AutoDarkLight









PIREP Submit




EncodeClose








PIREP Entry Results



The encoded PIREP should read as follows:





If this is correct click SUBMIT, otherwise click BACK


SubmitBack








Sign in










RegisterForgot PasswordLogin
------

You are accessing a U.S. Government information system, which includes: 1) this computer, 2) this computer network, 3) all Government-furnished computers connected to this network, and 4) all Government-furnished devices and storage media attached to this network or to a computer on this network. You understand and consent to the following: you may access this information system for authorized use only; unauthorized use of the system is prohibited and subject to criminal and civil penalties; you have no reasonable expectation of privacy regarding any communication or data transiting or stored on this information system at any time and for any lawful Government purpose, the Government may monitor, intercept, audit, and search and seize any communication or data transiting or stored on this information system; and any communications or data transiting or stored on this information system may be disclosed or used for any lawful Government purpose. This information system may contain Controlled Unclassified Information (CUI) that is subject to safeguarding or dissemination controls in accordance with law, regulation, or Government-wide policy. Accessing and using this system indicate your understanding of this warning.









Contact Us



Please see our FAQ for common questions.



Name:









Email:









Category:


Select a categoryQuestionSuggestionCommentReport a problemAccountsPIREP submitWIFSOutreachOther




Subject:









Captcha text:






SubmitClose







Data API

OpenAPI

Introduction

Using the API

Specifications

Cache



This service facilitates machine-to-machine access to aviation weather information. These pages describe how to use the API and the interactive interface under Specifications can be used to learn more about available data, configure specific queries, and try them out. The weather database currently allows access to up to the previous 15 days of data.

Please keep requests limited in scope and frequency. Maximum results per query apply as well as rate limiting against frequent requests. For larger queries, please consider using the cache files which provide quick access to complete datasets.

Products

Product	Description	Coverage	Formats
METAR	Terminal observations	Worldwide	Raw text, JSON, GeoJSON, CSV, XML, IWXXM
TAF	Terminal forecasts	Worldwide	Raw text, JSON, GeoJSON, XML, IWXXM
PIREPs/AIREPs	Pilot and aircraft reports	Primarily US and North Atlantic	Raw text, JSON, GeoJSON, XML
SIGMETs	Aviation warnings	Worldwide	Raw text, JSON, GeoJSON, XML
G-AIRMETs	Aviation advisories	Contiguous 48 United States	JSON, GeoJSON, XML
AIRMETs	Aviation advisories	Alaska	JSON, GeoJSON, XML, IWXXM
CONUS text AIRMETs were discontinued in January 2025. G-AIRMETs replace AIRMETs, increasing forecast precision in both time and space.
Area Forecast	Aviation forecasts	Alaska	Text
Area Forecast Discussions	Aviation discussions	United States	Text
Center Weather Advisories	Regional aviation advisories	United States	Raw text, JSON, GeoJSON
Meteorological Impact Statements	Aviation statements	United States	Text
TFM Convective Forecast (TCF)	Convective forecast	United States, portions of Canada	Raw text, GeoJSON
Legacy wind/temp tables	Wind and temperature forecasts	United States	Text
Station info	Weather observation station information	Worldwide	JSON, GeoJSON, XML
Airport info	Airport information	Worldwide	JSON, GeoJSON, XML
NAVAID, fix, feature, obstacle	Aviation navigation features	Worldwide	JSON, GeoJSON, XML

OpenAPI

Full API specification documentation is provided in OpenAPI YAML and the following interactive interface.




XML XSDs

aircraftreport

airsigmet

cwa

gairmet

metar

stationinfo

taf




Cache

The following files provide access to routinely updated full datasets. Use of these files is recommended instead of making excessively large or frequent custom queries, simplifying access to larger datasets, reducing system load, and improving access for all. All files are gzipped compressed text data.

Filename	Description	Update frequency
/data/cache/metars.cache.xml.gz	All current METARs (XML)	Once a minute
/data/cache/metars.cache.csv.gz	All current METARs (CSV)	Once a minute
/data/cache/tafs.cache.xml.gz	All current TAFs (XML)	Every 10 minutes
/data/cache/airsigmets.cache.xml.gz	All current CONUS SIGMETs (XML)	Once a minute
/data/cache/airsigmets.cache.csv.gz	All current CONUS SIGMETs (CSV)	Once a minute
/data/cache/gairmets.cache.xml.gz	All current CONUS G-AIRMETs (XML)	Once a minute
/data/cache/aircraftreports.cache.xml.gz	All current AIREPs/PIREPs (XML)	Once a minute
/data/cache/aircraftreports.cache.csv.gz	All current AIREPs/PIREPs (CSV)	Once a minute
/data/cache/stations.cache.xml.gz	Stations listing (XML)	Once a day
/data/cache/stations.cache.json.gz	Stations listing (JSON)	Once a day

Using the API

REST API endpoint are accessible at addresses under /api/data as outlined in the schema information. For example METARs are found at https://aviationweather.gov/api/data. Most requests require query parameters in order to specify constraints of the data being requested. For example the latest METAR from Kansas City International in JSON format can be requested by specifying the four letter ICAO identifier with https://aviationweather.gov/api/data/metar?ids=KMCI&format=json.

Requests may be made using most web browsers, command line utilities, and programming language libraries using modern HTTPS connections.

Guidelines

Please carefully consider requests to limit load on the system.

Set a custom user agent to prevent automated filtering inadvertently blocking valid traffic.

Wait between consecutive requests — maximum 100 requests per minute.

Exceeding request limits will result in access being temporarily blocked.

Restrictions

All requests are rate limited to 100 requests per minute and all API endpoints should not be consumed more frequently than 1 request/min per thread.

Most endpoints return a maximum of 400 entries (please consider using cache files for larger requests).

Cross-origin resource sharing is not permitted at this time.

Responses

Status code 204 is returned for valid requests with no data available (except GeoJSON).

JSON and XML formats return standardized error messages across endpoints.

Errors are returned using standard HTTP status codes as outline in the table below.

HTTP Status Code	Description
204 No Content	Request is valid however there is no data to be returned. For example no recent METARs available for a particular station or no SIGMETs valid at a particular time.
400 Invalid Request	The request is invalid in some way. This could include: Invalid parameters like format or date Missing parameters required to complete a request The URL is incorrect in some way.
404 Not Found	The endpoint or specific item requested does not exist.
429 Too Many Requests	Too many requests have been sent. You might see this error code when rate limits are applied. See Restrictions above.
500 Internal Server	The request may be valid but the system was unable to serve the request due to an error.
502 Bad Gateway 504 Gateway Timeout	Temporary service disruption.

Troubleshooting

Ensure your network connection is stable.

Verify that firewalls or proxies are not blocking your requests.

Ensure you are connecting via HTTPS.

Review OpenAPI documentation to ensure parameters are correct.

See the status page for the latest updates.







Privacy

Privacy Policy



FOIA

Freedom of Information Act



Glossary

NWS Glossary



Quality

Information Quality


Disclaimer

v4.24

------
导航页 打开网址