アクションリファレンス: Weather Forecast アクション | SORACOM Flux (Public beta)

Weather Forecast アクションは、位置情報に基づいて天気予報を取得し、次のチャネルに送信します。天気予報は、WeatherNews 社が提供する 1 km メッシュピンポイント天気予報を利用しています。

クレジットを消費します

Weather Forecast アクションは、1 リクエストごとに決められたクレジットを消費します。
クレジットが不足すると、Weather Forecast アクションは実行できません。
クレジットの詳細は SORACOM Flux の料金を参照してください。

日本国内の地点が対象です

Weather Forecast アクションで取得できる天気予報は、日本国内の地点が対象です。日本国外の地点を指定しないでください。
Weather Forecast アクションは、日本カバレッジだけで利用できます。カバレッジタイプについては、カバレッジタイプ (Coverage Type) の概要を参照してください。

Weather Forecast アクションの設定

CONDITION

[アクションの実行条件] に、アクションを実行する条件を指定できます。

この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: event.payload.temp) や、アクションを追加したチャネルに関するデータを表す式 (例: payload.temp) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法を参照してください。

CONFIG

天気予報のリクエストを設定します。

項目説明

[予報モード]

予報モードを選択します。

項目	説明
[特定日予報]	指定時刻に最も近い 1 日の天気予報を取得します。
[特定時刻予報]	指定時刻に最も近い毎時 00 分の予報を取得します。
[短期予報 (1 時間ごと)]	72 時間先までの 1 時間おきの天気予報を取得します。
[中期予報 (1 日ごと)]	10 日先までの 1 日ごとの天気予報を取得します。

[緯度]

取得する天気予報の地点の緯度を数値で入力します。小数度 (Decimal Degrees) 形式で入力してください (例: 35.6795)。日本国内の地点が対象となります。

この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法を参照してください。

[経度]

取得する天気予報の地点の経度を数値で入力します。小数度 (Decimal Degrees) 形式で入力してください (例: 139.7341)。日本国内の地点が対象となります。

この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法を参照してください。

[指定時刻]

時刻を UNIX 時間 (ミリ秒) で指定します。

[予報モード] で [特定日予報] を選択した場合は、指定した時刻を日本時間に換算して翌日の天気予報を取得します。たとえば、[指定時刻] に日本時間の 1 月 28 日 12 時 34 分の UNIX 時間 (ミリ秒) を指定した場合は、1 月 29 日の天気予報を取得できます。
ただし、日本時間の 00:00:00 を指定した場合は、翌日ではなく、当日の天気予報を取得します。
[予報モード] で [特定時刻予報] を選択した場合は、指定した時刻を日本時間に換算して次の時間の天気予報を取得します。たとえば、[指定時刻] に 13 時 00 分の UNIX 時間 (ミリ秒) を指定した場合は、13 時の天気予報を取得できます。また、13 時 01 分の UNIX 時間 (ミリ秒) を指定した場合は、14 時の天気予報を取得できます。
ただし、XX:00:00 を指定した場合は、次の時間ではなく、その時間 (XX 時) の天気予報を取得します。
この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法を参照してください。
また、実行時の現在時刻 (${now()}) を取得するなど、時刻に関する関数を使用できます。その他の関数はアクション、コンディションの記法を参照してください。

[指定時刻] は、[予報モード] で [特定日予報] または [特定時刻予報] を選択した場合のみ指定できます。

[表示言語] レスポンスの weather (天気コードに対応する天気表現) や windDirection (風向) の言語を指定します。

OUTPUT

アクションの出力データの取り扱いを設定します。

項目	説明
[アクションのアウトプットを別のチャネルに送信する]	「有効」にすると、アクションの出力データを別のチャネルに送信できます。
[送信先チャネル]	[新しくチャネルを作成する] を選択して、[チャネル名] にチャネルの名前を入力します。 [既存のチャネルを選択する] を選択して、既存のチャネルを選択します。

Weather Forecast アクションの出力データ

Weather Forecast アクションの出力データは、予報モードによって異なります。

予報モード: [特定時刻予報] または [短期予報 (1 時間ごと)] の場合

[特定時刻予報] の場合は、以下のオブジェクトが単独で返されます。
[短期予報 (1 時間ごと)] の場合は、以下のオブジェクトがリスト形式で返されます。

項目	説明
`timestamp`	天気予報の対象のタイムスタンプ (UNIX 時間 (ミリ秒))
`date`	天気予報の対象の日付 (ISO 8601 形式)
`wxCode`	天気コード
`weather`	天気コードに対応する天気表現
`imageUrl`	天気コードに対応する画像
`temperature`	気温 (°C)
`precipitation`	1 時間降水量 (mm/h)
`airPressure`	気圧 (hPa)
`windSpeed`	風速 (m/s)
`windDirectionCode`	風向 (記号)。例: SSW
`windDirection`	風向。例: 南南西
`humidity`	湿度 (%)

[短期予報 (1 時間ごと)] の例:

[
  {
    "timestamp": 1737943200000,
    "date": "2025-01-27T11:00:00+09:00",
    "wxCode": 100,
    "weather": "晴れ",
    "imageUrl": "https://images.soracom.io/icon/weather/weather-100.png?width=200",
    "temperature": 9,
    "precipitation": 0,
    "airPressure": 0,
    "windSpeed": 5,
    "windDirectionCode": "NNE",
    "windDirection": "北北東",
    "humidity": 53
  },
  {
    "timestamp": 1737946800000,
    "date": "2025-01-27T12:00:00+09:00",
    "wxCode": 100,
    "weather": "晴れ",
    "imageUrl": "https://images.soracom.io/icon/weather/weather-100.png?width=200",
    "temperature": 10,
    "precipitation": 0,
    "airPressure": 0,
    "windSpeed": 5,
    "windDirectionCode": "NNE",
    "windDirection": "北北東",
    "humidity": 52
  },
  ...
]

予報モード: [特定日予報] または [中期予報 (1 日ごと)] の場合

[特定日予報] の場合は、以下のオブジェクトが単独で返されます。
[中期予報 (1 時間ごと)] の場合は、以下のオブジェクトがリスト形式で返されます。

項目	説明
`timestamp`	天気予報の対象のタイムスタンプ (UNIX 時間 (ミリ秒))
`date`	天気予報の対象の日付 (ISO 8601 形式)
`wxCode`	天気コード
`weather`	天気コードに対応する天気表現
`imageUrl`	天気コードに対応する画像
`maxTemperature`	最高気温 (°C)
`minTemperature`	最低気温 (°C)
`pop`	降水確率 (%)

[中期予報 (1 時間ごと)] の例:

[
  {
    "timestamp": 1738022400000,
    "date": "2025-01-28T09:00:00+09:00",
    "wxCode": 101,
    "weather": "晴れ時々くもり",
    "imageUrl": "https://images.soracom.io/icon/weather/weather-101.png?width=200",
    "maxTemperature": 14,
    "minTemperature": 5,
    "pop": 20
  },
  {
    "timestamp": 1738108800000,
    "date": "2025-01-29T09:00:00+09:00",
    "wxCode": 101,
    "weather": "晴れ時々くもり",
    "imageUrl": "https://images.soracom.io/icon/weather/weather-101.png?width=200",
    "maxTemperature": 11,
    "minTemperature": 5,
    "pop": 20
  },
  ...
]

天気コード

Weather Forecast アクションが出力する天気コード (wxCode) の番号は、次の天気表現に対応しています。なお、以下の天気表現欄の内容は、weather (天気コードに対応する天気表現) と一致しない場合があります。

天気コード	天気表現
`100`	晴れ
`101`	晴れ時々くもり
`102`	晴れ一時雨
`103`	晴れ時々雨
`104`	晴れ一時雪
`105`	晴れ時々雪
`106`	晴れ一時雨か雪
`107`	晴れ時々雨か雪
`108`	晴れ一時雨か雷雨
`110`	晴れのち時々くもり
`111`	晴れのちくもり
`112`	晴れのち一時雨
`113`	晴れのち時々雨
`114`	晴れのち雨
`115`	晴れのち一時雪
`116`	晴れのち時々雪
`117`	晴れのち雪
`118`	晴れのち雨か雪
`119`	晴れのち雨か雷雨
`120`	晴れ朝夕一時雨
`121`	晴れ朝の内一時雨
`122`	晴れ夕方一時雨
`123`	晴れ山沿い雷雨
`124`	晴れ山沿い雪
`125`	晴れ午後は雷雨
`126`	晴れ昼頃から雨
`127`	晴れ夕方から雨
`128`	晴れ夜は雨
`129`	晴れ夜半から雨
`130`	朝の内霧のち晴れ
`131`	晴れ朝方霧
`132`	晴れ朝夕くもり
`140`	晴れ時々雨で雷を伴う
`160`	晴れ一時雪か雨
`170`	晴れ時々雪か雨
`181`	晴れのち雪か雨
`200`	くもり
`201`	くもり時々晴れ
`202`	くもり一時雨
`203`	くもり時々雨
`204`	くもり一時雪
`205`	くもり時々雪
`206`	くもり一時雨か雪
`207`	くもり時々雨か雪
`208`	くもり一時雨か雷雨
`209`	霧
`210`	くもりのち時々晴れ
`211`	くもりのち晴れ
`212`	くもりのち一時雨
`213`	くもりのち時々雨
`214`	くもりのち雨
`215`	くもりのち一時雪
`216`	くもりのち時々雪
`217`	くもりのち雪
`218`	くもりのち雨か雪
`219`	くもりのち雨か雷雨
`220`	くもり朝夕一時雨
`221`	くもり朝の内一時雨
`222`	くもり夕方一時雨
`223`	くもり日中時々晴れ
`224`	くもり昼頃から雨
`225`	くもり夕方から雨
`226`	くもり夜は雨
`227`	くもり夜半から雨
`228`	くもり昼頃から雪
`229`	くもり夕方から雪
`230`	くもり夜は雪
`231`	くもり海上海岸は霧か霧雨
`240`	くもり時々雨で雷を伴う
`250`	くもり時々雪で雷を伴う
`260`	くもり一時雪か雨
`270`	くもり時々雪か雨
`281`	くもりのち雪か雨
`300`	雨
`301`	雨時々晴れ
`302`	雨時々止む
`303`	雨時々雪
`304`	雨か雪
`306`	大雨
`308`	雨で暴風を伴う
`309`	雨一時雪
`311`	雨のち晴れ
`313`	雨のちくもり
`314`	雨のち時々雪
`315`	雨のち雪
`316`	雨か雪のち晴れ
`317`	雨か雪のちくもり
`320`	朝の内雨のち晴れ
`321`	朝の内雨のちくもり
`322`	雨朝晩一時雪
`323`	雨昼頃から晴れ
`324`	雨夕方から晴れ
`325`	雨夜は晴れ
`326`	雨夕方から雪
`327`	雨夜は雪
`328`	雨一時強く降る
`329`	雨一時みぞれ
`340`	雪か雨
`350`	雨で雷を伴う
`361`	雪か雨のち晴れ
`371`	雪か雨のちくもり
`400`	雪
`401`	雪時々晴れ
`402`	雪時々止む
`403`	雪時々雨
`405`	大雪
`406`	風雪強い
`407`	暴風雪
`409`	雪一時雨
`411`	雪のち晴れ
`413`	雪のちくもり
`414`	雪のち雨
`420`	朝の内雪のち晴れ
`421`	朝の内雪のちくもり
`422`	雪昼頃から雨
`423`	雪夕方から雨
`424`	雪夜半から雨
`425`	雪一時強く降る
`426`	雪のちみぞれ
`427`	雪一時みぞれ
`430`	みぞれ
`450`	雪で雷を伴う
`500`	快晴
`550`	猛暑
`552`	猛暑時々曇り
`553`	猛暑時々雨
`558`	猛暑時々大雨・嵐
`562`	猛暑のち曇り
`563`	猛暑のち雨
`568`	猛暑のち大雨・嵐
`572`	曇り時々猛暑
`573`	雨時々猛暑
`582`	曇りのち猛暑
`583`	雨のち猛暑
`600`	うすぐもり
`650`	小雨
`800`	雷
`850`	大雨・嵐
`851`	大雨・嵐時々晴れ
`852`	大雨・嵐時々曇り
`853`	大雨・嵐時々雨
`854`	大雨・嵐時々雪
`855`	大雨・嵐時々猛暑
`859`	大雨・嵐一時大雪
`861`	大雨・嵐のち晴れ
`862`	大雨・嵐のち曇り
`863`	大雨・嵐のち雨
`864`	大雨・嵐のち雪
`865`	大雨・嵐のち猛暑
`869`	大雨・嵐のち大雪
`871`	晴れ時々大雨・嵐
`872`	曇り時々大雨・嵐
`873`	雨時々大雨・嵐
`874`	雪時々大雨・嵐
`881`	晴れのち大雨・嵐
`882`	曇りのち大雨・嵐
`883`	雨のち大雨・嵐
`884`	雪のち大雨・嵐
`950`	大雪
`951`	大雪時々晴れ
`952`	大雪時々曇
`953`	大雪一時雨
`954`	大雪時々雪
`958`	大雪一時大雨
`961`	大雪のち晴れ
`962`	大雪のち曇
`963`	大雪のち雨
`964`	大雪のち雪
`968`	大雪のち大雨・嵐
`971`	晴れ一時大雪
`972`	曇一時大雪
`973`	雨一時大雪
`974`	雪一時大雪
`981`	晴れのち大雪
`982`	曇のち大雪
`983`	雨のち大雪
`984`	雪のち大雪
`999`	No Data

Soracom

Users

Weather Forecast アクション