Method: history.hours.lookup

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

HTTP-запрос

GET https://weather.googleapis.com/v1/history/hours:lookup

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

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

Параметры
location

object ( LatLng )

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

unitsSystem

enum ( UnitsSystem )

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

pageSize

integer

Необязательно. Максимальное количество почасовых исторических записей, возвращаемых на странице — от 1 до 24 (включительно). Значение по умолчанию — максимально допустимое значение 24.

pageToken

string

Необязательный. Токен страницы, полученный из предыдущего запроса. Используется для получения следующей страницы.

hours

integer

Необязательно. Ограничивает общее количество часов для извлечения, начиная с последнего часа: от 1 до 24 (включительно). Значение по умолчанию — максимально допустимое значение 24.

languageCode

string

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

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

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

Тело ответа

Ответ на запрос hours.lookup RPC.

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

JSON-представление 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Поля
historyHours[]

object ( HistoryHour )

Почасовые исторические записи в соответствии с количеством часов и размером страницы, указанными в запросе.

timeZone

object ( TimeZone )

Часовой пояс в запрашиваемом месте.

nextPageToken

string

Токен для получения следующей страницы.

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

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

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

HistoryHour

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

JSON-представление 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Поля
interval

object ( Interval )

Эти исторические данные действительны в течение часового интервала (по времени UTC) (временные метки округляются до ближайшего часа).

displayDateTime

object ( DateTime )

Локальная дата и время в часовом поясе местоположения (гражданское время), для которого рассчитывается эта почасовая запись. Это поле может использоваться для отображения в клиенте. Примечание: эта дата будет состоять из года, месяца, дня, часа и смещения относительно UTC.

weatherCondition

object ( WeatherCondition )

Исторические погодные условия.

temperature

object ( Temperature )

Историческая температура.

feelsLikeTemperature

object ( Temperature )

Показатель ощутимой температуры в указанном месте.

dewPoint

object ( Temperature )

Историческая температура точки росы.

heatIndex

object ( Temperature )

Исторический индекс температуры тепла.

windChill

object ( Temperature )

Историческое воздействие ветра на кожу, температура воздуха.

wetBulbTemperature

object ( Temperature )

Историческая температура влажного термометра — самая низкая температура, достижимая при испарении воды.

precipitation

object ( Precipitation )

Историческая вероятность осадков и количество осадков, накопленных за последний час.

airPressure

object ( AirPressure )

Исторические условия давления воздуха.

wind

object ( Wind )

Исторические ветровые условия.

visibility

object ( Visibility )

Историческая видимость.

iceThickness

object ( IceThickness )

Историческая толщина льда.

isDaytime

boolean

True, если этот час находится между местным временем восхода (включительно) и временем заката (исключая). В противном случае это ночь (между заходом и следующим восходом). Примечание: этот час будет считаться днём или ночью, если интервал пересекается с местным временем восхода и захода соответственно (например, если интервал длится с 5:00 до 6:00, а восход солнца происходит в 5:59, то isDaytime будет true).

relativeHumidity

integer

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

uvIndex

integer

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

thunderstormProbability

integer

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

cloudCover

integer

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