Method: forecast.days.lookup

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

HTTP-запрос

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

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

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

Параметры
location

object ( LatLng )

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

unitsSystem

enum ( UnitsSystem )

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

pageSize

integer

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

pageToken

string

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

days

integer

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

languageCode

string

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

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

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

Тело ответа

Ответ на days.lookup RPC.

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

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

object ( ForecastDay )

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

timeZone

object ( TimeZone )

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

nextPageToken

string

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

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

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

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

ПрогнозДня

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

JSON-представление 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  }
}
Поля
interval

object ( Interval )

Интервал времени UTC, в течение которого прогнозируемый день начинается (включительно) и заканчивается (не включая). Примечание: день начинается в 7:00 и заканчивается в 7:00 следующего дня по местному времени. Например: если местный часовой пояс — UTC-7, то интервал начнётся в 14:00:00.000Z и закончится в тот же час следующего дня.

displayDate

object ( Date )

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

daytimeForecast

object ( ForecastDayPart )

Прогнозируемые погодные условия на дневное время суток (с 7:00 до 19:00 по местному времени).

nighttimeForecast

object ( ForecastDayPart )

Прогнозируемые погодные условия на ночную часть суток (с 19:00 до 7:00 следующего дня по местному времени).

maxTemperature

object ( Temperature )

Максимальная (высокая) температура в течение дня.

minTemperature

object ( Temperature )

Минимальная (низкая) температура в течение дня.

feelsLikeMaxTemperature

object ( Temperature )

Максимальная (высокая) ощущаемая температура в течение дня.

feelsLikeMinTemperature

object ( Temperature )

Минимальная (низкая) ощущаемая температура в течение дня.

maxHeatIndex

object ( Temperature )

Максимальная температура индекса тепла в течение дня.

sunEvents

object ( SunEvents )

События, связанные с солнцем (например, восход, закат).

moonEvents

object ( MoonEvents )

События, связанные с луной (например, восход луны, заход луны).

Дата

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

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Похожие типы:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должен быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должен быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должен быть от 1 до 31 и действителен для года и месяца, или 0, чтобы указать только год или год и месяц, если день не имеет значения.

ПрогнозЧастиДня

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

JSON-представление 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Поля
interval

object ( Interval )

Дата и время UTC начала (включительно) и окончания (не включая) этой части суток. Примечание: часть суток начинается в 7:00 и заканчивается в 19:00 того же дня по местному времени. Например, если местный часовой пояс — UTC-7, то дневной интервал начнётся в 14:00:00.000Z и закончится в 02:00:00.000Z следующего дня, а ночной интервал начнётся в 02:00:00.000Z следующего дня и закончится в 14:00:00.000Z того же дня.

weatherCondition

object ( WeatherCondition )

Прогнозируемые погодные условия.

precipitation

object ( Precipitation )

Прогнозируемое количество осадков.

wind

object ( Wind )

Среднее направление ветра, максимальная скорость и порыв.

iceThickness

object ( IceThickness )

Накопленное количество льда за часть дня.

relativeHumidity

integer

Прогнозируемый процент относительной влажности (значения от 0 до 100).

uvIndex

integer

Максимальный прогнозируемый ультрафиолетовый (УФ) индекс.

thunderstormProbability

integer

Средняя вероятность грозы.

cloudCover

integer

Средний процент облачности.

SunEvents

Представляет события, связанные с солнцем (например, восход, закат).

JSON-представление 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Поля
sunriseTime

string ( Timestamp format)

Время восхода солнца.

ПРИМЕЧАНИЕ: В некоторых случаях (например, к северу от Полярного круга) время восхода Солнца может отсутствовать. В таких случаях это поле будет не заполнено.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

sunsetTime

string ( Timestamp format)

Время, когда солнце садится.

ПРИМЕЧАНИЕ: В некоторых случаях (например, к северу от Полярного круга) время заката может отсутствовать. В таких случаях это поле будет не заполнено.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

MoonEvents

Представляет события, связанные с луной (например, восход луны, заход луны).

JSON-представление 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Поля
moonriseTimes[]

string ( Timestamp format)

Время, когда верхняя часть Луны появляется над горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset) .

ПРИМЕЧАНИЕ: В большинстве случаев в день будет только одно время восхода Луны. В других случаях список может быть пустым (например, если Луна взойдет после полуночи следующего дня). Однако в отдельных случаях (например, в полярных регионах) список может содержать несколько значений. В таких случаях значения сортируются по возрастанию.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

moonsetTimes[]

string ( Timestamp format)

Время, когда верхняя часть Луны скрывается за горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset) .

ПРИМЕЧАНИЕ: В большинстве случаев время захода Луны будет одним в сутки. В других случаях список может быть пустым (например, если Луна заходит после полуночи следующего дня). Однако в отдельных случаях (например, в полярных регионах) список может содержать несколько значений. В таких случаях значения сортируются по возрастанию.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

moonPhase

enum ( MoonPhase )

Фаза Луны (она же лунная фаза).

Фаза Луны

Отмечает фазу Луны (она же лунная фаза).

Перечисления
MOON_PHASE_UNSPECIFIED Неопределенная фаза Луны.
NEW_MOON Луна не освещена солнцем.
WAXING_CRESCENT Луна освещена на 0%-50% с правой стороны в северном полушарии 🌒 и с левой стороны в южном полушарии 🌘.
FIRST_QUARTER Луна освещена на 50,1% с правой стороны в северном полушарии 🌓 и с левой стороны в южном полушарии 🌗.
WAXING_GIBBOUS Луна освещена на 50%-100% с правой стороны в северном полушарии 🌔 и с левой стороны в южном полушарии 🌖.
FULL_MOON Луна полностью освещена.
WANING_GIBBOUS Луна освещена на 50%-100% с левой стороны в северном полушарии 🌖 и с правой стороны в южном полушарии 🌔.
LAST_QUARTER Луна освещена на 50,1% с левой стороны в северном полушарии 🌗 и с правой стороны в южном полушарии 🌓.
WANING_CRESCENT Луна освещена на 0%-50% с левой стороны в северном полушарии 🌘 и с правой стороны в южном полушарии 🌒.