Files
public-weather/national_weather_service_api.md
T
Lukas Werner 4cd69217cc version 1.0
2025-06-25 18:58:43 -07:00

10 KiB

Get Forecast

GET https://api.weather.gov/gridpoints/PQR/116,103/forecast

{
  "@context": [
    "https://geojson.org/geojson-ld/geojson-context.jsonld",
    {
      "@version": "1.1",
      "wx": "https://api.weather.gov/ontology#",
      "geo": "http://www.opengis.net/ont/geosparql#",
      "unit": "http://codes.wmo.int/common/unit/",
      "@vocab": "https://api.weather.gov/ontology#"
    }
  ],
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -122.5566,
          45.5102
        ],
        [
          -122.56280000000001,
          45.531
        ],
        [
          -122.5926,
          45.5267
        ],
        [
          -122.5864,
          45.505899899999996
        ],
        [
          -122.5566,
          45.5102
        ]
      ]
    ]
  },
  "properties": {
    "units": "us",
    "forecastGenerator": "BaselineForecastGenerator",
    "generatedAt": "2025-06-26T01:32:44+00:00",
    "updateTime": "2025-06-26T00:40:50+00:00",
    "validTimes": "2025-06-25T18:00:00+00:00/P7DT10H",
    "elevation": {
      "unitCode": "wmoUnit:m",
      "value": 85.9536
    },
    "periods": [
      {
        "number": 1,
        "name": "Tonight",
        "startTime": "2025-06-25T18:00:00-07:00",
        "endTime": "2025-06-26T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 58,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 31
        },
        "windSpeed": "2 to 6 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/night/ovc/rain,30?size=medium",
        "shortForecast": "Cloudy then Chance Drizzle",
        "detailedForecast": "A chance of drizzle after 5am. Cloudy, with a low around 58. North northwest wind 2 to 6 mph. Chance of precipitation is 30%."
      },
      {
        "number": 2,
        "name": "Thursday",
        "startTime": "2025-06-26T06:00:00-07:00",
        "endTime": "2025-06-26T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 69,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 31
        },
        "windSpeed": "2 to 6 mph",
        "windDirection": "SW",
        "icon": "https://api.weather.gov/icons/land/day/rain,30/rain,20?size=medium",
        "shortForecast": "Chance Drizzle",
        "detailedForecast": "A chance of drizzle before 2pm. Mostly cloudy, with a high near 69. Southwest wind 2 to 6 mph. Chance of precipitation is 30%."
      },
      {
        "number": 3,
        "name": "Thursday Night",
        "startTime": "2025-06-26T18:00:00-07:00",
        "endTime": "2025-06-27T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 56,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 8
        },
        "windSpeed": "2 to 6 mph",
        "windDirection": "NW",
        "icon": "https://api.weather.gov/icons/land/night/bkn?size=medium",
        "shortForecast": "Mostly Cloudy",
        "detailedForecast": "Mostly cloudy, with a low around 56. Northwest wind 2 to 6 mph."
      },
      {
        "number": 4,
        "name": "Friday",
        "startTime": "2025-06-27T06:00:00-07:00",
        "endTime": "2025-06-27T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 73,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 3
        },
        "windSpeed": "2 to 6 mph",
        "windDirection": "WNW",
        "icon": "https://api.weather.gov/icons/land/day/bkn?size=medium",
        "shortForecast": "Partly Sunny",
        "detailedForecast": "Partly sunny, with a high near 73. West northwest wind 2 to 6 mph."
      },
      {
        "number": 5,
        "name": "Friday Night",
        "startTime": "2025-06-27T18:00:00-07:00",
        "endTime": "2025-06-28T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 55,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 2
        },
        "windSpeed": "2 to 6 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/night/sct?size=medium",
        "shortForecast": "Partly Cloudy",
        "detailedForecast": "Partly cloudy, with a low around 55. North northwest wind 2 to 6 mph."
      },
      {
        "number": 6,
        "name": "Saturday",
        "startTime": "2025-06-28T06:00:00-07:00",
        "endTime": "2025-06-28T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 80,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 0
        },
        "windSpeed": "2 to 9 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/day/few?size=medium",
        "shortForecast": "Sunny",
        "detailedForecast": "Sunny, with a high near 80."
      },
      {
        "number": 7,
        "name": "Saturday Night",
        "startTime": "2025-06-28T18:00:00-07:00",
        "endTime": "2025-06-29T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 56,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 0
        },
        "windSpeed": "3 to 9 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/night/skc?size=medium",
        "shortForecast": "Clear",
        "detailedForecast": "Clear, with a low around 56."
      },
      {
        "number": 8,
        "name": "Sunday",
        "startTime": "2025-06-29T06:00:00-07:00",
        "endTime": "2025-06-29T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 88,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 0
        },
        "windSpeed": "3 to 10 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/day/skc?size=medium",
        "shortForecast": "Sunny",
        "detailedForecast": "Sunny, with a high near 88."
      },
      {
        "number": 9,
        "name": "Sunday Night",
        "startTime": "2025-06-29T18:00:00-07:00",
        "endTime": "2025-06-30T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 60,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 1
        },
        "windSpeed": "2 to 10 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/night/skc?size=medium",
        "shortForecast": "Clear",
        "detailedForecast": "Clear, with a low around 60."
      },
      {
        "number": 10,
        "name": "Monday",
        "startTime": "2025-06-30T06:00:00-07:00",
        "endTime": "2025-06-30T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 90,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 7
        },
        "windSpeed": "2 to 10 mph",
        "windDirection": "NNW",
        "icon": "https://api.weather.gov/icons/land/day/few?size=medium",
        "shortForecast": "Sunny",
        "detailedForecast": "Sunny, with a high near 90."
      },
      {
        "number": 11,
        "name": "Monday Night",
        "startTime": "2025-06-30T18:00:00-07:00",
        "endTime": "2025-07-01T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 61,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 7
        },
        "windSpeed": "2 to 10 mph",
        "windDirection": "NW",
        "icon": "https://api.weather.gov/icons/land/night/sct?size=medium",
        "shortForecast": "Partly Cloudy",
        "detailedForecast": "Partly cloudy, with a low around 61."
      },
      {
        "number": 12,
        "name": "Tuesday",
        "startTime": "2025-07-01T06:00:00-07:00",
        "endTime": "2025-07-01T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 87,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 4
        },
        "windSpeed": "2 to 10 mph",
        "windDirection": "NW",
        "icon": "https://api.weather.gov/icons/land/day/sct?size=medium",
        "shortForecast": "Mostly Sunny",
        "detailedForecast": "Mostly sunny, with a high near 87."
      },
      {
        "number": 13,
        "name": "Tuesday Night",
        "startTime": "2025-07-01T18:00:00-07:00",
        "endTime": "2025-07-02T06:00:00-07:00",
        "isDaytime": false,
        "temperature": 59,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 4
        },
        "windSpeed": "2 to 10 mph",
        "windDirection": "NW",
        "icon": "https://api.weather.gov/icons/land/night/few?size=medium",
        "shortForecast": "Mostly Clear",
        "detailedForecast": "Mostly clear, with a low around 59."
      },
      {
        "number": 14,
        "name": "Wednesday",
        "startTime": "2025-07-02T06:00:00-07:00",
        "endTime": "2025-07-02T18:00:00-07:00",
        "isDaytime": true,
        "temperature": 83,
        "temperatureUnit": "F",
        "temperatureTrend": "",
        "probabilityOfPrecipitation": {
          "unitCode": "wmoUnit:percent",
          "value": 3
        },
        "windSpeed": "2 to 9 mph",
        "windDirection": "NW",
        "icon": "https://api.weather.gov/icons/land/day/few?size=medium",
        "shortForecast": "Sunny",
        "detailedForecast": "Sunny, with a high near 83."
      }
    ]
  }
}