Method: history.hours.lookup

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

HTTP-запрос

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

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

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

Параметры
location

object ( LatLng )

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

units System

enum ( UnitsSystem )

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

page Size

integer

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

page Token

string

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

hours

integer

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

language Code

string

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

Тело запроса

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

Тело ответа

Ответ на RPChours.lookup.

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

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

object ( HistoryHour )

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

time Zone

object ( TimeZone )

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

next Page Token

string

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

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

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

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

Час истории

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

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), для которого действительны эти исторические данные (временные метки округляются до ближайшего часа).

display Date Time

object ( DateTime )

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

weather Condition

object ( WeatherCondition )

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

temperature

object ( Temperature )

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

feels Like Temperature

object ( Temperature )

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

dew Point

object ( Temperature )

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

heat Index

object ( Temperature )

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

wind Chill

object ( Temperature )

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

wet Bulb Temperature

object ( Temperature )

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

precipitation

object ( Precipitation )

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

air Pressure

object ( AirPressure )

Исторические условия атмосферного давления.

wind

object ( Wind )

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

visibility

object ( Visibility )

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

ice Thickness

object ( IceThickness )

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

is Daytime

boolean

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

relative Humidity

integer

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

uv Index

integer

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

thunderstorm Probability

integer

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

cloud Cover

integer

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