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

325 lines
10 KiB
Markdown

## Get Forecast
`GET https://api.weather.gov/gridpoints/PQR/116,103/forecast`
```json
{
"@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."
}
]
}
}
```