Method: currentConditions.lookup

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

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

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

Параметры
location

object (LatLng)

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

enum (UnitsSystem)

Необязательное поле. Система единиц измерения, которая будет использоваться для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут в метрической системе (по умолчанию = METRIC).
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. Допустимы и другие типы нормализации. Примеры: "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

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

integer

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

integer

Текущий УФ-индекс.
thunderstormProbability

integer

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

Примечание. Это поле не включается в ответ для местоположений в Японии и Южной Корее.
cloudCover

integer

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

Примечание. Это поле не включается в ответ для местоположений в Японии и Южной Корее.

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

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

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

CurrentConditionsHistory

Представляет собой набор изменений текущих условий за последние 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)

Количество снега, которое, по прогнозам, выпадет за определенный период времени, при условии, что он не будет таять или уплотняться. Примечание. Это фактическое количество снега, а не его эквивалент в жидкой воде. QPF – это аббревиатура для Quantitative Precipitation Forecast (количественный прогноз осадков). Подробную информацию можно найти в определении QuantitativePrecipitationForecast.
qpf

object (QuantitativePrecipitationForecast)

Общее количество осадков (дождь, снег, град и т. д.), которое ожидается за определенный период времени. Примечание. QPF – это аббревиатура от Quantitative Precipitation Forecast (количественный прогноз осадков). Подробную информацию вы найдете в определении QuantitativePrecipitationForecast.