Method: currentConditions.lookup

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
location

object (LatLng)

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

string (Timestamp format)

Current time (UTC) associated with the returned data.

Uses RFC 3339, where generated output will always be Z-normalized and use 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".
timeZone

object (TimeZone)

The time zone at the requested location.
weatherCondition

object (WeatherCondition)

The current weather condition.
temperature

object (Temperature)

The current temperature.
feelsLikeTemperature

object (Temperature)

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

object (Temperature)

The current dew point temperature.
heatIndex

object (Temperature)

The current heat index temperature.
windChill

object (Temperature)

The current wind chill, air temperature exposed on the skin.

Note: This field returns an empty object for locations in Japan and South Korea.
precipitation

object (Precipitation)

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

object (AirPressure)

The current air pressure conditions.
wind

object (Wind)

The current wind conditions.
visibility

object (Visibility)

The current visibility.

Note: This field returns an empty object for locations in Japan and South Korea.
currentConditionsHistory

object (CurrentConditionsHistory)

The changes in the current conditions over the last 24 hours.
isDaytime

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).
relativeHumidity

integer

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

integer

The current ultraviolet (UV) index.
thunderstormProbability

integer

The current thunderstorm probability (values from 0 to 100).

Note: This field is omitted from the response for locations in Japan and South Korea.
cloudCover

integer

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

Note: This field is omitted from the response for locations in Japan and South Korea.

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.

JSON representation 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Fields
temperatureChange

object (Temperature)

The current temperature minus the temperature 24 hours ago.
maxTemperature

object (Temperature)

The maximum (high) temperature in the past 24 hours.
minTemperature

object (Temperature)

The minimum (low) temperature in the past 24 hours.
snowQpf

object (QuantitativePrecipitationForecast)

The amount of snow that is predicted to fall over a period of time, assuming no melting or compaction. Note: This is the actual snow amount, not its liquid water equivalent. QPF is an abbreviation for Quantitative Precipitation Forecast (please see the QuantitativePrecipitationForecast definition for more details).
qpf

object (QuantitativePrecipitationForecast)

The total liquid water equivalent of all precipitation (rain, snow, ice, etc.) that is predicted to fall over a period of time. Note: QPF is an abbreviation for Quantitative Precipitation Forecast (please see the QuantitativePrecipitationForecast definition for more details).