Weather API の概要

Weather API を使用すると、世界中の場所のリアルタイムで地域ごとの天気データをリクエストして、ライブ天気ダッシュボード、天気更新アプリ、ルート天気オーバーレイ、天気ベースの健康管理やアクティビティ トラッカーを強化できます。気象情報には、現在の気温、降水量、相対湿度、風速、UV 指数などが含まれます。

この API は、指定された緯度と経度の位置情報について、次の表のデータのエンドポイント（https://weather.googleapis.com/v1/...）を提供します。

REST エンドポイントの概要

API エンドポイント URL 説明 文書化されたパラメータ
現在の天気情報 https://weather.googleapis.com/v1/currentConditions:lookup 現在の気象状況 location.latitude、location.longitude
1 時間ごとの天気予報 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
1 時間ごとの履歴 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

一般的なユースケース

Weather API の機能

Weather API のデータには、次のものが含まれます。

  • 気象条件とアイコン: weatherCondition の現在の気象条件（「曇り」や「にわか雪」など）を示す説明と対応するアイコン。
  • 気温: 現在の気温（temperature）、最低気温と最高気温（1 日の天気予報では minTemperature と maxTemperature、または currentConditionsHistory 内）、体感温度（feelsLikeTemperature）。
  • 降水量: 総降水量と降水の種類（雪、雨、氷、混合）。
  • 風: 風冷指数（windChill）、風向（wind.direction）、風速（wind.speed）、突風（wind.gust）。
  • 氷の厚さ: 氷の厚さ。
  • 湿度: 露点温度（dewPoint）、熱指数（heatIndex）、湿球温度（wetBulbTemperature）、相対湿度（relativeHumidity）。
  • UV 指数: 紫外線（UV）指数（uvIndex）。
  • 雷雨の確率: 雷雨が発生する確率（パーセント）。
  • 視程: 物体がはっきりと見える距離。
  • 気圧: 平均海面気圧。
  • 太陽と月のイベント: 日の出、日の入り、月の出、月の入りの時刻。
  • 雲量: 雲に覆われている空の割合。

Weather API の使用方法

1 セットアップする Google Cloud プロジェクトを設定するから始めて、以降の手順を完了します。
2 現在の状況を取得する 現在の状況を取得するをご覧ください。
3 1 時間ごとの天気予報を取得する 1 時間ごとの予報を取得するをご覧ください。
4 1 日の天気予報を確認する 毎日の予測を取得するをご覧ください。
5 1 時間ごとの履歴を取得する 1 時間ごとの履歴を取得するをご覧ください。
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）

次のステップ