Get Started Contact sales

    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.
    units System

    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).
    page Size

    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.
    page Token

    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.
    language Code

    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
    history Hours[]

    object ( HistoryHour )

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

    object ( TimeZone )

    The time zone at the requested location.
    next Page Token

    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).
    display Date Time

    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.
    weather Condition

    object ( WeatherCondition )

    The historical weather condition.
    temperature

    object ( Temperature )

    The historical temperature.
    feels Like Temperature

    object ( Temperature )

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

    object ( Temperature )

    The historical dew point temperature.
    heat Index

    object ( Temperature )

    The historical heat index temperature.
    wind Chill

    object ( Temperature )

    The historical wind chill, air temperature exposed on the skin.
    wet Bulb Temperature

    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.
    air Pressure

    object ( AirPressure )

    The historical air pressure conditions.
    wind

    object ( Wind )

    The historical wind conditions.
    visibility

    object ( Visibility )

    The historical visibility.
    ice Thickness

    object ( IceThickness )

    The historical ice thickness.
    is Daytime

    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).
    relative Humidity

    integer

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

    integer

    The historical ultraviolet (UV) index.
    thunderstorm Probability

    integer

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

    integer

    The historical percentage of the sky covered by clouds (values from 0 to 100).
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: