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

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

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

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

Условия

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

1.1 Требования к указанию авторства. Если Заказчик использует контент Google Maps из API погоды, он обязан указать авторство в соответствии с Документацией .

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

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

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

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

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

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

Для запроса поминутных прогнозов отправьте 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 в качестве входного параметра в следующем запросе. Необязательный

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

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"
    },
    ...
  ]
}