Конечная точка 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 |
Запрошенная система единиц измерения. Возможные значения:
Если система мер не указана, по умолчанию используется |
Необязательно |
pageSize |
Указывает максимальное количество результатов, которые нужно вернуть. | Необязательно |
pageToken |
Токен страницы, полученный из предыдущего запроса. Чтобы получить следующую страницу данных, передайте pageToken в качестве входного параметра в следующем запросе. |
Необязательно |
О поминутных прогнозах
Weather API возвращает в теле ответа следующие поля:
| Поле | Описание |
|---|---|
overallPredictionTimeframe |
Общий период времени для прогнозов. |
overallPredictionTimeframe.startTime |
Время начала периода прогнозирования. Это начальная точка отсчета. |
overallPredictionTimeframe.endTime |
Время окончания периода прогнозирования. По умолчанию это время наступает через шесть часов после начала. |
timeZone |
Часовой пояс запрашиваемого местоположения. |
segments |
Сегменты прогноза на уровне минут, обозначенные как timeFrame. |
segments.timeFrame |
Временные рамки, относящиеся к сегменту. |
segments.timeFrame.startTime |
Время начала сегмента. |
segments.timeFrame.endTime |
Время окончания сегмента. |
segments.type |
Прогнозируемый тип осадков в течение этого сегмента. Возможные варианты:
|
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). Возможные значения:
Примечание. Убедитесь, что ваш клиент может обрабатывать неизвестные значения. |
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" }, ... ] }