Получить поминутный прогноз (экспериментальная функция)

Конечная точка forecast:minutes предоставляет поминутный прогноз осадков в высоком разрешении (также известный как текущий прогноз) для заданного местоположения.

API возвращает следующую информацию за шестичасовой период:

  • Время начала и окончания периода прогнозирования.
  • Часовой пояс запрашиваемого местоположения.
  • время начала и окончания каждого сегмента прогноза;
  • Прогнозируемый тип, вероятность, количество и интенсивность осадков в течение каждого сегмента.

Условия использования

Эти условия выпущены в соответствии с разделом 6 (Условия использования предварительных версий) Специальных условий использования платформы Google Карт, согласованных между вами и Google.

1.1. Требования к указанию авторства. Если Клиент использует Контент Google Карт из Weather API, он должен указать авторство Google в соответствии с Документацией.

1.2. Ограничения. Клиенты не могут использовать контент Google Карт, полученный из Weather API, для воссоздания сервиса или продукта Google (например, использовать данные, полученные из Weather API, в приложении или модели погоды, основная цель которых – предоставлять информацию о погоде).

1.3. Кеширование. Клиенты могут временно кешировать Контент Google Карт, полученный из Weather API, в течение Периода кеширования, указанного в таблице 1.3.1 (Разрешения на кеширование).

Таблица 1.3.1. Разрешения на кеширование

Эти разрешения дополняют описанные в таблице 17.2.1 Специальных условий платформы Google Карт.

Контент Google Карт Период кеширования
Прогнозируемые значения за минуту Один час, после чего Клиент должен удалить кешированный Контент Google Карт.

Запросы прогнозов по минутам

Чтобы запросить поминутный прогноз, отправьте HTTP-запрос методом GET по следующему адресу:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

Включите в параметры запроса координаты широты и долготы местоположения.

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

Конечная точка forecast.minutes принимает следующие параметры запроса:

Параметр Описание Обязательный?
location.latitude Широта запрашиваемого местоположения. Обязательно
location.longitude Долгота запрашиваемого местоположения. Обязательно
unitsSystem Запрошенная система единиц измерения. Возможные значения:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

Если система мер не указана, по умолчанию используется METRIC.

Необязательно
pageSize Указывает максимальное количество результатов, которые нужно вернуть. Необязательно
pageToken Токен страницы, полученный из предыдущего запроса. Чтобы получить следующую страницу данных, передайте pageToken в качестве входного параметра в следующем запросе. Необязательно

О поминутных прогнозах

Weather API возвращает в теле ответа следующие поля:

Поле Описание
overallPredictionTimeframe Общий период времени для прогнозов.
overallPredictionTimeframe.startTime Время начала периода прогнозирования. Это начальная точка отсчета.
overallPredictionTimeframe.endTime Время окончания периода прогнозирования. По умолчанию это время наступает через шесть часов после начала.
timeZone Часовой пояс запрашиваемого местоположения.
segments Сегменты прогноза на уровне минут, обозначенные как timeFrame.
segments.timeFrame Временные рамки, относящиеся к сегменту.
segments.timeFrame.startTime Время начала сегмента.
segments.timeFrame.endTime Время окончания сегмента.
segments.type Прогнозируемый тип осадков в течение этого сегмента. Возможные варианты:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability Прогнозируемая вероятность осадков в течение этого сегмента. Значения указываются в процентах от 0 до 100.
segments.qpf Количественный прогноз осадков.
segments.qpf.quantity Прогнозируемое количество осадков в течение этого сегмента.
segments.qpf.unit Единица измерения количества выпавших осадков, например MILLIMETERS или INCHES.
segments.snowfallAmount Прогнозируемое количество снега за этот период.
segments.snowfallAmount.quantity Прогнозируемое количество снега (в жидком эквиваленте) в течение этого периода.
segments.snowfallAmount.unit Единица измерения количества выпавшего снега (например, MILLIMETERS, INCHES).
segments.intensity Интенсивность осадков на сегменте (PrecipitationIntensity). Возможные значения:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • MID_LIGHT
  • LIGHT
  • MID_MODERATE
  • MODERATE
  • MID_HEAVY
  • HEAVY

Примечание. Убедитесь, что ваш клиент может обрабатывать неизвестные значения.

nextPageToken Токен, который можно отправить как pageToken, чтобы получить следующую страницу. Если это поле отсутствует, значит последующих страниц нет.

Пример прогноза по минутам

В следующем примере запрашивается поминутный прогноз для местоположения в Западной Вирджинии:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

В ответе объект segments указывает на каждый сегмент общего временного интервала прогноза:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}