Method: forecast.hours.lookup

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

HTTP-запрос

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

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

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

Параметры
location

object ( LatLng )

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

unitsSystem

enum ( UnitsSystem )

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

pageSize

integer

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

pageToken

string

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

hours

integer

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

languageCode

string

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

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

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

Тело ответа

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

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

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

object ( ForecastHour )

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

timeZone

object ( TimeZone )

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

nextPageToken

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

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