List of "weather" values

[netbymatt]

When viewing a gridpoint endpoint such as https://api.weather.gov/gridpoints/LOT/58,72 There's an array of weather values at properties.weather which is an array of structures that when you drill down into it has a text string "weather" that lists some values such as "snow", "rain" or "thunderstorms" as well as null which seems to map to no precipitation but could have cloud cover.

Is there a list of possible values that can appear in this field?

For reference this may currently have a similar answer to #107

[charliesneath]

It’s worth noting that the list of values at https://api.weather.gov/icons (referenced in #107) doesn’t seem to be exhaustive. For example, I’m currently seeing “snow_showers” in forecast data but don’t see that value listed at that link.

[scadergit]

@charliesneath will you provide the full url of the icon property in the forecast response?

[charliesneath]

@scadergit I'm looking at https://api.weather.gov/gridpoints/BOX/60,79

Here's a snippet of the relevant part (capturing before forecast changes!):

{
    "@context": [
        "https://geojson.org/geojson-ld/geojson-context.jsonld",
        {
            "@version": "1.1",
            "wmoUnit": "https://codes.wmo.int/common/unit/",
            "nwsUnit": "https://api.weather.gov/ontology/unit/"
        }
    ],
    "id": "https://api.weather.gov/gridpoints/BOX/60,79",
    "type": "Feature",
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    -71.356866800000006,
                    42.476737499999999
                ],
                [
                    -71.361978000000008,
                    42.4553346
                ],
                [
                    -71.332973800000005,
                    42.451562799999998
                ],
                [
                    -71.327856600000004,
                    42.472965299999998
                ],
                [
                    -71.356866800000006,
                    42.476737499999999
                ]
            ]
        ]
    },
    "properties": {
        "@id": "https://api.weather.gov/gridpoints/BOX/60,79",
        "@type": "wx:Gridpoint",
        "updateTime": "2020-12-17T18:07:50+00:00",
        "validTimes": "2020-12-17T12:00:00+00:00/P8DT6H",
        "elevation": {
            "unitCode": "wmoUnit:m",
            "value": 45.110399999999998
        },
        "forecastOffice": "https://api.weather.gov/offices/BOX",
        "gridId": "BOX",
        "gridX": "60",
        "gridY": "79",

        ...

        "weather": {
            "values": [
                {
                    "validTime": "2020-12-17T12:00:00+00:00/PT4H",
                    "value": [
                        {
                            "coverage": "definite",
                            "weather": "snow",
                            "intensity": "moderate",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 0.80467200000000005
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "freezing_fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 0.80467200000000005
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T16:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "likely",
                            "weather": "snow",
                            "intensity": "moderate",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 0.80467200000000005
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "freezing_fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 0.80467200000000005
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T17:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "likely",
                            "weather": "snow",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T18:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "definite",
                            "weather": "snow",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 1.6093440000000001
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 1.6093440000000001
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T19:00:00+00:00/PT2H",
                    "value": [
                        {
                            "coverage": "definite",
                            "weather": "snow",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 2.4140160000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 2.4140160000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T21:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "likely",
                            "weather": "snow",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 1.6093440000000001
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 1.6093440000000001
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T22:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "snow",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 2.4140160000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 2.4140160000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-17T23:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "slight_chance",
                            "weather": "snow",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 6.4373760000000004
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 6.4373760000000004
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-18T00:00:00+00:00/P2DT12H",
                    "value": [
                        {
                            "coverage": null,
                            "weather": null,
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": null
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-20T12:00:00+00:00/PT5H",
                    "value": [
                        {
                            "coverage": "slight_chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-20T17:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-20T18:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "slight_chance",
                            "weather": "rain_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-20T19:00:00+00:00/PT1H",
                    "value": [
                        {
                            "coverage": "slight_chance",
                            "weather": "rain_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 8.0467200000000005
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 8.0467200000000005
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-20T20:00:00+00:00/PT2H",
                    "value": [
                        {
                            "coverage": "slight_chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-20T22:00:00+00:00/P1DT7H",
                    "value": [
                        {
                            "coverage": null,
                            "weather": null,
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": null
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-22T05:00:00+00:00/PT4H",
                    "value": [
                        {
                            "coverage": "slight_chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-22T09:00:00+00:00/P1DT18H",
                    "value": [
                        {
                            "coverage": null,
                            "weather": null,
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": null
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-24T03:00:00+00:00/PT2H",
                    "value": [
                        {
                            "coverage": "slight_chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-24T05:00:00+00:00/PT7H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-24T12:00:00+00:00/PT2H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "rain_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 8.0467200000000005
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 8.0467200000000005
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-24T14:00:00+00:00/PT19H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "rain_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 16091.830656
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-25T09:00:00+00:00/PT5H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "snow_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        },
                        {
                            "coverage": "patchy",
                            "weather": "fog",
                            "intensity": null,
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 3.2186880000000002
                            },
                            "attributes": []
                        }
                    ]
                },
                {
                    "validTime": "2020-12-25T14:00:00+00:00/PT4H",
                    "value": [
                        {
                            "coverage": "chance",
                            "weather": "rain_showers",
                            "intensity": "light",
                            "visibility": {
                                "unitCode": "wmoUnit:km",
                                "value": 16091.830656
                            },
                            "attributes": []
                        }
                    ]
                }
            ]
        }
    }
}

[StephenClouse]

Please have a look at https://github.com/weather-gov/api/issues/14#issuecomment-660207899

This is the full OpenAPI definition that will be coming in our next release. This should also be valid for the current release.

[scadergit]

...that and I incorrectly thought you were looking at a gridpoint /forecast endpoint. The icons endpoint does not represent values in the forecast netcdf grids provided by the field office. The icons endpoint only encompasses the icon options generated by the API to correlate with the generated weather phrasing.