Method: currentConditions.lookup

HTTP request
Query parameters
Request body
Response body
- JSON representation
Authorization scopes
CurrentConditionsHistory
- JSON representation

Returns the current weather conditions at a given location.

HTTP request

GET https://weather.googleapis.com/v1/currentConditions:lookup

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters

Parameters
`location`	`object ( LatLng )` Required. The location to get the current weather conditions 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).
`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".

location

object ( LatLng )

Required. The location to get the current weather conditions 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).

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 currentConditions.lookup RPC - represents the current weather conditions at the requested location.

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

JSON representation

JSON representation
{ "currentTime" : string , "timeZone" : { object ( `TimeZone` ) } , "weatherCondition" : { object ( `WeatherCondition` ) } , "temperature" : { object ( `Temperature` ) } , "feelsLikeTemperature" : { object ( `Temperature` ) } , "dewPoint" : { object ( `Temperature` ) } , "heatIndex" : { object ( `Temperature` ) } , "windChill" : { object ( `Temperature` ) } , "precipitation" : { object ( `Precipitation` ) } , "airPressure" : { object ( `AirPressure` ) } , "wind" : { object ( `Wind` ) } , "visibility" : { object ( `Visibility` ) } , "currentConditionsHistory" : { object ( `CurrentConditionsHistory` ) } , "isDaytime" : boolean , "relativeHumidity" : integer , "uvIndex" : integer , "thunderstormProbability" : integer , "cloudCover" : integer }

 { 
 "currentTime" 
 : 
 string 
 , 
 "timeZone" 
 : 
 { 
 object (  TimeZone 
 
) 
 } 
 , 
 "weatherCondition" 
 : 
 { 
 object (  WeatherCondition 
 
) 
 } 
 , 
 "temperature" 
 : 
 { 
 object (  Temperature 
 
) 
 } 
 , 
 "feelsLikeTemperature" 
 : 
 { 
 object (  Temperature 
 
) 
 } 
 , 
 "dewPoint" 
 : 
 { 
 object (  Temperature 
 
) 
 } 
 , 
 "heatIndex" 
 : 
 { 
 object (  Temperature 
 
) 
 } 
 , 
 "windChill" 
 : 
 { 
 object (  Temperature 
 
) 
 } 
 , 
 "precipitation" 
 : 
 { 
 object (  Precipitation 
 
) 
 } 
 , 
 "airPressure" 
 : 
 { 
 object (  AirPressure 
 
) 
 } 
 , 
 "wind" 
 : 
 { 
 object (  Wind 
 
) 
 } 
 , 
 "visibility" 
 : 
 { 
 object (  Visibility 
 
) 
 } 
 , 
 "currentConditionsHistory" 
 : 
 { 
 object (  CurrentConditionsHistory 
 
) 
 } 
 , 
 "isDaytime" 
 : 
 boolean 
 , 
 "relativeHumidity" 
 : 
 integer 
 , 
 "uvIndex" 
 : 
 integer 
 , 
 "thunderstormProbability" 
 : 
 integer 
 , 
 "cloudCover" 
 : 
 integer 
 }

Fields
`current Time`	`string ( Timestamp format)` Current time (UTC) associated with the returned data. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"` , `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"` .
`time Zone`	`object ( TimeZone )` The time zone at the requested location.
`weather Condition`	`object ( WeatherCondition )` The current weather condition.
`temperature`	`object ( Temperature )` The current temperature.
`feels Like Temperature`	`object ( Temperature )` The measure of how the temperature currently feels like at the requested location.
`dew Point`	`object ( Temperature )` The current dew point temperature.
`heat Index`	`object ( Temperature )` The current heat index temperature.
`wind Chill`	`object ( Temperature )` The current wind chill, air temperature exposed on the skin.
`precipitation`	`object ( Precipitation )` The current precipitation probability and amount of precipitation accumulated over the last hour.
`air Pressure`	`object ( AirPressure )` The current air pressure conditions.
`wind`	`object ( Wind )` The current wind conditions.
`visibility`	`object ( Visibility )` The current visibility.
`current Conditions History`	`object ( CurrentConditionsHistory )` The changes in the current conditions over the last 24 hours.
`is Daytime`	`boolean` True if the current time at the requested location is between the local sunrise (inclusive) and the sunset (exclusive) times. Otherwise, it is nighttime (between the sunset and the next sunrise).
`relative Humidity`	`integer` The current percent of relative humidity (values from 0 to 100).
`uv Index`	`integer` The current ultraviolet (UV) index.
`thunderstorm Probability`	`integer` The current thunderstorm probability (values from 0 to 100).
`cloud Cover`	`integer` The current percentage of the sky covered by clouds (values from 0 to 100).

Authorization scopes

Requires the following OAuth scope:

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

CurrentConditionsHistory

Represents a set of changes in the current conditions over the last 24 hours.