Обзор Weather API

Weather API позволяет запрашивать гиперлокальные данные о погоде в реальном времени для местоположений по всему миру. Эти данные можно использовать для создания панелей мониторинга погоды, приложений с прогнозом погоды, наложений погоды на маршруты, а также трекеров здоровья или активности, основанных на погоде. Информация о погоде включает текущую температуру, осадки, относительную влажность, скорость ветра, УФ-индекс и т. д.

Для местоположения с заданной широтой и долготой API предоставляет конечные точки (https://weather.googleapis.com/v1/...) для данных, указанных в таблице ниже.

Обзор конечных точек REST

Конечная точка API URL Описание Документированные параметры
Текущая погода https://weather.googleapis.com/v1/currentConditions:lookup Погода в реальном времени location.latitude, location.longitude
Прогноз погоды по часам https://weather.googleapis.com/v1/forecast/hours:lookup Прогноз погоды на срок до 240 часов. location.latitude, location.longitude
Прогноз по дням https://weather.googleapis.com/v1/forecast/days:lookup Прогноз погоды на срок до 10 дней. location.latitude, location.longitude
Почасовая история https://weather.googleapis.com/v1/history/hours:lookup Кэшированные данные о погоде за последние 24 часа. location.latitude, location.longitude
Предупреждения об опасных погодных условиях https://weather.googleapis.com/v1/publicAlerts:lookup Предупреждения об опасных погодных условиях key, location.latitude, location.longitude

Примеры использования

  • Панели с текущей погодой и обновлением погоды. Запрашивайте currentConditions:lookup, forecast/hours:lookup и forecast/days:lookup, используя GPS-координаты (location.latitude и location.longitude) или геокодированные координаты города, чтобы показывать автоматически обновляемые данные о температуре, влажности и скорости ветра.
  • Оверлеи с погодой на маршруте. Выберите путевые точки с широтой и долготой на ломаной линии маршрута из Routes API и вызовите currentConditions:lookup или forecast/hours:lookup для расчетного времени прибытия в каждую путевую точку, чтобы предупреждать водителей об изменении погодных условий.
  • Трекеры здоровья, потребления воды и активности, учитывающие погоду. Получайте данные о temperature, feelsLikeTemperature, relativeHumidity, heatIndex и uvIndex из currentConditions:lookup, чтобы корректировать ежедневные цели по потреблению воды или рекомендации по тренировкам на открытом воздухе.

Функции Weather API

Данные Weather API включают:

  • Погодные условия и значки. Описание и соответствующий значок, указывающие на текущие погодные условия (например, "Облачно" или "Местами снег") в weatherCondition.
  • Температура. Текущая температура (temperature), минимальная и максимальная температура (minTemperature и maxTemperature в прогнозах на день или внутри currentConditionsHistory), а также ощущаемая температура (feelsLikeTemperature).
  • Осадки. Общее количество осадков и их тип (снег, дождь, лед, смешанные осадки).
  • Ветер: температура с учетом ветра (windChill), направление ветра (wind.direction), скорость ветра (wind.speed) и порывы ветра (wind.gust).
  • Толщина льда.
  • Влажность. Точка росы (dewPoint), тепловой индекс (heatIndex), температура влажного термометра (wetBulbTemperature) и относительная влажность (relativeHumidity).
  • УФ-индекс. Индекс ультрафиолетового излучения (uvIndex).
  • Вероятность грозы. Вероятность грозы в процентах.
  • Видимость. Расстояние, на котором объект хорошо виден.
  • Атмосферное давление. Среднее атмосферное давление на уровне моря.
  • События, связанные с солнцем и луной. Время восхода и заката солнца и луны.
  • Облачность. Процент неба, закрытый облаками.

Как использовать Weather API

1 Настройка Начните с раздела Как настроить облачный проект Google Cloud и выполните приведенные в нем инструкции.
2 Как узнать текущую погоду Подробнее о том, как узнать текущие условия…
3 Почасовой прогноз погоды Подробнее о том, как получить прогноз погоды по часам…
4 Прогноз погоды на день Подробнее о том, как получать ежедневный прогноз погоды…
5 Как посмотреть историю за час Подробнее о том, как получить почасовую историю…
6 Как получать оповещения о погоде Подробнее о том, как получать оповещения о погоде…

Чтобы получить индекс качества воздуха (AQI) и данные о загрязнении твердыми частицами (PM2.5, PM10), используйте Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup). Weather API не возвращает эти значения.

Другие связанные API окружающей среды включают:

  • Концентрация пыльцы: Pollen API (https://pollen.googleapis.com/v1/forecast:lookup)
  • Солнечная радиация и потенциал крыш: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Дальнейшие действия