Method: forecast.hours.lookup

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

HTTP-запрос

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

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

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

Параметры
location

object ( LatLng )

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

units System

enum ( UnitsSystem )

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

page Size

integer

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

page Token

string

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

hours

integer

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

language Code

string

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

Тело запроса

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

Тело ответа

Ответ на RPChours.lookup.

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

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

object ( ForecastHour )

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

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