Method: currentConditions.lookup

Возвращает текущие погодные условия в заданном месте.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры запроса

Параметры
location

object ( LatLng )

Обязательно. Местоположение, для которого необходимо получить текущие погодные условия.

unitsSystem

enum ( UnitsSystem )

Необязательно. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ).

languageCode

string

Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en».

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ на RPC currentConditions.lookup — представляет текущие погодные условия в запрошенном месте.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление
{
  "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 ( Timestamp format)

Текущее время (UTC), связанное с возвращенными данными.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

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 )

Изменения текущих условий за последние 24 часа.

isDaytime

boolean

Истина, если текущее время в указанном месте находится между местным временем восхода солнца (включительно) и временем захода солнца (исключительно). В противном случае — ночь (между временем захода солнца и следующим восходом солнца).

relativeHumidity

integer

Текущий процент относительной влажности (значения от 0 до 100).

uvIndex

integer

Текущий ультрафиолетовый (УФ) индекс.

thunderstormProbability

integer

Текущая вероятность грозы (значения от 0 до 100).

cloudCover

integer

Текущий процент неба, закрытый облаками (значения от 0 до 100).

Области авторизации

Требуется следующая область OAuth:

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

ТекущиеСостоянияИстория

Представляет собой набор изменений текущих условий за последние 24 часа.

JSON-представление
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Поля
temperatureChange

object ( Temperature )

Текущая температура минус температура 24 часа назад.

maxTemperature

object ( Temperature )

Максимальная (высокая) температура за последние 24 часа.

minTemperature

object ( Temperature )

Минимальная (низкая) температура за последние 24 часа.

snowQpf

object ( QuantitativePrecipitationForecast )

Количество снега, измеренное в эквиваленте жидкой воды, выпавшего за последние 24 часа. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast).

qpf

object ( QuantitativePrecipitationForecast )

Количество осадков, измеренное в жидком водном эквиваленте, накопленное за последние 24 часа. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast).