Method: forecast.days.lookup

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

HTTP-запрос

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

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

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

Параметры
location

object ( LatLng )

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

units System

enum ( UnitsSystem )

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

page Size

integer

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

page Token

string

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

days

integer

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

language Code

string

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

Тело запроса

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

Тело ответа

Ответ на RPC дней.lookup.

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

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

object ( ForecastDay )

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

time Zone

object ( TimeZone )

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

next Page Token

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)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Поля
interval

object ( Interval )

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

display Date

object ( Date )

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

daytime Forecast

object ( ForecastDayPart )

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

nighttime Forecast

object ( ForecastDayPart )

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

max Temperature

object ( Temperature )

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

min Temperature

object ( Temperature )

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

feels Like Max Temperature

object ( Temperature )

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

feels Like Min Temperature

object ( Temperature )

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

max Heat Index

object ( Temperature )

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

sun Events

object ( SunEvents )

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

moon Events

object ( MoonEvents )

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

ice Thickness

object ( IceThickness )

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

Дата

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

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

Связанные типы:

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)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Поля
interval

object ( Interval )

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

weather Condition

object ( WeatherCondition )

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

precipitation

object ( Precipitation )

Прогнозируемые осадки.

wind

object ( Wind )

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

relative Humidity

integer

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

uv Index

integer

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

thunderstorm Probability

integer

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

cloud Cover

integer

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

SunEvents

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

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

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

sunset Time

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

ЛунаСобытия

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

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

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

moonset Times[]

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

moon Phase

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 % с левой стороны в северном полушарии 🌘 и с правой стороны в южном полушарии 🌒.