Method: history.hours.lookup

Returns up to 24 hours of hourly historical weather data at a given location, starting from the last hour.

HTTP request

GET https://weather.googleapis.com/v1/history/hours:lookup

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
location

object (LatLng)

Required. The location to get the hourly historical data for.
unitsSystem

enum (UnitsSystem)

Optional. The units system to use for the returned weather conditions. If not provided, the returned weather conditions will be in the metric system (default = METRIC).
pageSize

integer

Optional. The maximum number of hourly historical records to return per page - a value from 1 to 24 (inclusive). The default is the maximum allowed value of 24.
pageToken

string

Optional. A page token received from a previous request. It is used to retrieve the subsequent page.
hours

integer

Optional. Limits the amount of total hours to fetch starting from the last hour - a from 1 to 24 (inclusive). The default is the maximum allowed value of 24.
languageCode

string

Optional. Allows the client to choose the language for the response. If data cannot be provided for that language, the API uses the closest match. Allowed values rely on the IETF BCP-47 standard. The default value is "en".

Request body

The request body must be empty.

Response body

Response for the hours.lookup RPC.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Fields
historyHours[]

object (HistoryHour)

The hourly historical records, according to the number of hours and page size specified in the request.
timeZone

object (TimeZone)

The time zone at the requested location.
nextPageToken

string

The token to retrieve the next page.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

HistoryHour

Represents an hourly history record at a given location.

JSON representation 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Fields
interval

object (Interval)

The one hour interval (in UTC time) this historical data is valid for (the timestamps are rounded down to the closest hour).
displayDateTime

object (DateTime)

The local date and time in the time zone of the location (civil time) which this hourly record is calculated for. This field may be used for display purposes on the client. Note: this date will consist of the year, month, day, hour and offset from UTC.
weatherCondition

object (WeatherCondition)

The historical weather condition.
temperature

object (Temperature)

The historical temperature.
feelsLikeTemperature

object (Temperature)

The measure of how the temperature felt like at the requested location.
dewPoint

object (Temperature)

The historical dew point temperature.
heatIndex

object (Temperature)

The historical heat index temperature.
windChill

object (Temperature)

The historical wind chill, air temperature exposed on the skin.
wetBulbTemperature

object (Temperature)

The historical wet bulb temperature, lowest temperature achievable by evaporating water.
precipitation

object (Precipitation)

The historical precipitation probability and amount of precipitation accumulated over the last hour.
airPressure

object (AirPressure)

The historical air pressure conditions.
wind

object (Wind)

The historical wind conditions.
visibility

object (Visibility)

The historical visibility.
iceThickness

object (IceThickness)

The historical ice thickness.
isDaytime

boolean

True if this hour is between the local sunrise (inclusive) and sunset (exclusive) times. Otherwise, it is nighttime (between the sunset and the next sunrise). Note: this hour will be considered as daytime or nighttime if the interval intersects with the local sunrise and sunset times respectively (e.g.: if the interval is from 5am to 6am and sunrise is at 5:59am, then isDaytime will be true).
relativeHumidity

integer

The historical percent of relative humidity (values from 0 to 100).
uvIndex

integer

The historical ultraviolet (UV) index.
thunderstormProbability

integer

The historical thunderstorm probability (values from 0 to 100).
cloudCover

integer

The historical percentage of the sky covered by clouds (values from 0 to 100).