Method: lookupWeather

Узнайте погоду в определенном месте.

HTTP-запрос

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

URL имеет синтаксис gRPC Transcoding.

Тело запроса

Ниже приведена структура данных в теле запроса.

JSON-представление 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Поля
unitsSystem

enum (UnitsSystem)

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

object (Location)

Обязательно. Местоположение, для которого нужно получить прогноз погоды.
capabilities[]

enum (Capability)

Необязательное поле. Возможности среды, которые нужно включить в ответ.
date

object (Date)

Необязательное поле. Указывает дату, за которую запрашивается информация об окружающей среде, в соответствии с местным часовым поясом местоположения, указанного в поле location. Поддерживаемые диапазоны дат зависят от запрашиваемых возможностей: - WEATHER: до 24 часов в прошлом (если также задано hour) и до 10 дней (240 часов) в будущем (с сегодняшнего дня до +9 дней для ежедневных прогнозов). - AIR_QUALITY: до 30 дней (720 часов) в прошлом и до 4 дней (96 часов) в будущем. - POLLEN: от сегодняшнего дня до +4 дней (до 5 дней, включая сегодняшний; прошедшие даты не поддерживаются).
hour

integer

Необязательное поле. Указывает час, за который запрашивается информация об окружающей среде, в 24-часовом формате (0–23) относительно местного часового пояса местоположения, указанного в поле location. Требуется указать date. Поддерживаемые почасовые диапазоны зависят от запрашиваемых возможностей: - WEATHER: до 24 часов в прошлом и до 240 часов (10 дней) в будущем. - AIR_QUALITY: до 30 дней (720 часов) в прошлом и до 4 дней (96 часов) в будущем. - POLLEN: возвращает только ежедневные прогнозы; hour игнорируется для пыльцы.
languageCode

string

Необязательное поле. Код языка по стандарту BCP-47 для локализованного текста в ответе (например, "ru", "ja", "fr-CA"). Если не указано, по умолчанию используется "en".
weatherOptions

object (WeatherOptions)

Необязательное поле. Параметры, относящиеся к запросам о погоде. weatherOptions.units_system поддерживается вместе с unitsSystem верхнего уровня (тег 4) для обеспечения обратной совместимости с существующими вызывающими объектами. Если обе системы единиц измерения конфликтуют, возвращается INVALID_ARGUMENT. Игнорируется, если параметр WEATHER не запрашивается в capabilities.
airQualityOptions

object (AirQualityOptions)

Необязательное поле. Параметры, относящиеся к запросам качества воздуха. Игнорируется, если AIR_QUALITY не запрашивается в capabilities.

Тело ответа

Если ответ получен успешно, его тело содержит экземпляр LookupWeatherResponse.

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

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

  • https://www.googleapis.com/auth/maps-platform.mapstools