491
NOUS41 KWBC 202130
PNSWSH

Service Change Notice 24-55
National Weather Service Headquarters Silver Spring MD
530 PM EDT Mon May 20 2024

TO:  Subscribers:
  -NOAA Weather Wire Service
  -Emergency Managers Weather Information Network
  -NOAAPort
  Other NWS Partners, Users and NWS Employees

FROM:  Ben Kyger
  Director, NCEP Central Operations (NCO)

SUBJECT:  Upgrade NWS API Website Forecast and Alerts Endpoints,
  Effective June 20th, 2024

On or about June 20th, 2024 at 1400 Universal Coordinated Time (UTC),
the
National Weather Service API Application Programming Interface
(Website)
will be upgraded to version 1.13. With this upgrade comes the
following
user-impactful changes:

1. Removal of the following parameters from the
  /gridpoint//,/forecast endpoint:
  updated, Relative Humidity, and Dewpoint

Example: https://api.weather.gov/gridpoints/EAX/45,35/forecast

 A) Users who are using the updated parameter in their parsing
of the
    data can use the updateTime field which shows the same
time.

 B) The Relative Humidity and Dewpoint values are being removed as
they
    are not scientifically accurate. These parameters will still be
    available on the /gridpoint//, and
   /gridpoint//,/forecast/hourly endpoints.

2. Requests to the alerts endpoint with the active and zone
parameters
  will be redirected to the discrete endpoint.

Example:
https://api.weather.gov/alerts?active=true&zone=WYZ118

Will be redirected to:

https://api.weather.gov/alerts/active/zone/WYZ118

Additionally, users are advised that the active parameter on the
/alerts
endpoint is deprecated and is subject to removal in a future update
of the
API. The /alerts/active endpoint should be used as the replacement.

3. Resolution of WFO Anchorage (AFC) errors on the points and
gridpoints
  endpoints.
Examples of endpoints that are being resolved:
https://api.weather.gov/points/61.2175,-149.8583

This will now return values for forecast, forecastHourly,
forecastGridData, and observations.

https://api.weather.gov/gridpoints/AER/126,236/forecast

and
https://api.weather.gov/gridpoints/AER/126,236/forecast/hourly

also will return data.

For operational issues on the API Website, please contact:

NCEP Central Operations
Tech Control
nco.ops@noaa.gov

For technical questions regarding this notification, please contact:

Anne Myckow
Software Development Branch
NWS Office of Dissemination
sdb.support@noaa.gov

National Service Change Notices are online at:

https://www.weather.gov/notification