Weather.gov · Schema

GridpointHourlyForecastPeriod

An object containing forecast information for a specific time period (generally 12-hour or 1-hour).

WeatherGovernmentUnited StatesForecastingAlertsOpen Data

Properties

Name	Type	Description
number	integer	Sequential period number.
name	string	A textual identifier for the period. This value will not be present for hourly forecasts.
startTime	string	The starting time that this forecast period is valid for.
endTime	string	The ending time that this forecast period is valid for.
isDaytime	boolean	Indicates whether this period is daytime or nighttime.
temperature	object	High/low temperature for the period, depending on whether the period is day or night. This property as an integer value is deprecated. Future versions will express this value as a quantitative value o
temperatureUnit	string	The unit of the temperature value (Fahrenheit or Celsius). This property is deprecated. Future versions will indicate the unit within the quantitative value object for the temperature property. To mak
temperatureTrend	stringnull	If not null, indicates a non-diurnal temperature trend for the period (either rising temperature overnight, or falling temperature during the day)
probabilityOfPrecipitation	object	Probability of precipitation for the period.
dewpoint	object	Dewpoint. Only provided in hourly forecasts.
relativeHumidity	object	Relative humidity. Only provided in hourly forecasts.
windSpeed	object	Wind speed for the period. This property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard format now, set th
windGust	object	Peak wind gust for the period. This property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard format now, se
windDirection	string	The prevailing direction of the wind for the period, using a 16-point compass.
icon	string	A link to an icon representing the forecast summary.
shortForecast	string	A brief textual forecast summary for the period.
detailedForecast	string	A detailed textual forecast for the period.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/weather-gov/refs/heads/main/json-schema/weather-gov-gridpoint-hourly-forecast-period-schema.json",
  "title": "GridpointHourlyForecastPeriod",
  "description": "An object containing forecast information for a specific time period (generally 12-hour or 1-hour).\n",
  "type": "object",
  "properties": {
    "number": {
      "minimum": 1,
      "type": "integer",
      "description": "Sequential period number."
    },
    "name": {
      "type": "string",
      "description": "A textual identifier for the period. This value will not be present for hourly forecasts.\n",
      "examples": [
        "Tuesday Night"
      ]
    },
    "startTime": {
      "type": "string",
      "description": "The starting time that this forecast period is valid for.",
      "format": "date-time"
    },
    "endTime": {
      "type": "string",
      "description": "The ending time that this forecast period is valid for.",
      "format": "date-time"
    },
    "isDaytime": {
      "type": "boolean",
      "description": "Indicates whether this period is daytime or nighttime."
    },
    "temperature": {
      "oneOf": [
        {
          "$ref": "#/components/schemas/QuantitativeValue"
        },
        {
          "type": "integer"
        }
      ],
      "description": "High/low temperature for the period, depending on whether the period is day or night.\nThis property as an integer value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard format now, set the \"forecast_temperature_qv\" feature flag on the request.\n"
    },
    "temperatureUnit": {
      "enum": [
        "F",
        "C"
      ],
      "type": "string",
      "description": "The unit of the temperature value (Fahrenheit or Celsius).\nThis property is deprecated. Future versions will indicate the unit within the quantitative value object for the temperature property. To make use of the future standard format now, set the \"forecast_temperature_qv\" feature flag on the request.\n",
      "deprecated": true
    },
    "temperatureTrend": {
      "enum": [
        "rising",
        "falling"
      ],
      "type": [
        "string",
        "null"
      ],
      "description": "If not null, indicates a non-diurnal temperature trend for the period (either rising temperature overnight, or falling temperature during the day)\n"
    },
    "probabilityOfPrecipitation": {
      "$ref": "#/components/schemas/QuantitativeValue",
      "description": "Probability of precipitation for the period."
    },
    "dewpoint": {
      "$ref": "#/components/schemas/QuantitativeValue",
      "description": "Dewpoint. Only provided in hourly forecasts.\n"
    },
    "relativeHumidity": {
      "$ref": "#/components/schemas/QuantitativeValue",
      "description": "Relative humidity. Only provided in hourly forecasts.\n"
    },
    "windSpeed": {
      "oneOf": [
        {
          "$ref": "#/components/schemas/QuantitativeValue"
        },
        {
          "type": "string"
        }
      ],
      "description": "Wind speed for the period.\nThis property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard format now, set the \"forecast_wind_speed_qv\" feature flag on the request.\n"
    },
    "windGust": {
      "oneOf": [
        {
          "$ref": "#/components/schemas/QuantitativeValue"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Peak wind gust for the period.\nThis property as an string value is deprecated. Future versions will express this value as a quantitative value object. To make use of the future standard format now, set the \"forecast_wind_speed_qv\" feature flag on the request.\n"
    },
    "windDirection": {
      "enum": [
        "N",
        "NNE",
        "NE",
        "ENE",
        "E",
        "ESE",
        "SE",
        "SSE",
        "S",
        "SSW",
        "SW",
        "WSW",
        "W",
        "WNW",
        "NW",
        "NNW"
      ],
      "type": "string",
      "description": "The prevailing direction of the wind for the period, using a 16-point compass."
    },
    "icon": {
      "type": "string",
      "description": "A link to an icon representing the forecast summary.",
      "format": "uri",
      "deprecated": true
    },
    "shortForecast": {
      "type": "string",
      "description": "A brief textual forecast summary for the period."
    },
    "detailedForecast": {
      "type": "string",
      "description": "A detailed textual forecast for the period."
    }
  },
  "additionalProperties": false
}