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

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

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

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

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

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

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

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 Интенсивность осадков в сегменте. Возможные значения:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • 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"
    },
    ...
  ]
}