Returns up to 240 hours of hourly forecasts at a given location, starting from the current hour.
HTTP request
GET https://weather.googleapis.com/v1/forecast/hours:lookup
The URL uses gRPC Transcoding syntax.
Query parameters
Parameters | |
---|---|
location |
Required. The location to get the hourly forecast for. |
units |
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 |
Optional. The maximum number of hourly forecast records to return per page - a value from 1 to 24 (inclusive). The default is the maximum allowed value of 24. |
page |
Optional. A page token received from a previous request. It is used to retrieve the subsequent page. |
hours |
Optional. Limits the amount of total hours to fetch starting from the current hour - a value from 1 to 240 (inclusive). The default is the maximum allowed value of 240. |
language |
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 |
---|
{ "forecastHours": [ { object ( |
Fields | |
---|---|
forecast |
The hourly forecast records, according to the number of hours and page size specified in the request. |
time |
The time zone at the requested location. |
next |
The token to retrieve the next page. |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
ForecastHour
Represents an hourly forecast record at a given location.
JSON representation |
---|
{ "interval": { object ( |
Fields | |
---|---|
interval |
The one hour interval (in UTC time) this forecast data is valid for (the timestamps are rounded down to the closest hour). |
display |
The local date and time in the time zone of the location (civil time) which this hourly forecast 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 |
The foreacasted weather condition. |
temperature |
The forecasted temperature. |
feels |
The measure of how the temperature will feel like at the requested location. |
dew |
The forecasted dew point temperature. |
heat |
The forecasted heat index temperature. |
wind |
The forecasted wind chill, air temperature exposed on the skin. |
wet |
The forecasted wet bulb temperature, lowest temperature achievable by evaporating water. |
precipitation |
The forecasted precipitation probability and amount of precipitation accumulated over the last hour. |
air |
The forecasted air pressure conditions. |
wind |
The forecasted wind conditions. |
visibility |
The forecasted visibility. |
ice |
The forecasted ice thickness. |
is |
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 |
The forecasted percent of relative humidity (values from 0 to 100). |
uv |
The forecasted ultraviolet (UV) index. |
thunderstorm |
The forecasted thunderstorm probability (values from 0 to 100). |
cloud |
The forecasted percentage of the sky covered by clouds (values from 0 to 100). |