Schema forecast-season v1.0.0
XMLをJSON化したデータのスキーマ情報を提供しています。
対象とするXML電文
共通ヘッダ
共通ヘッダはこちら
本文
body フィールド内の定義となります。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 1.? | notice | お知らせがある場合 | String お知らせを記載する |
| 2. | target | Object 電文が対象とする地域を記載する #2. target | |
| 3. | seasons | Array<Object> 季節予報の内容に関する事項を記載する #3. season | |
| 4.? | timeSeries | 暖候期予報・寒候期予報の場合は出現しない | Array<Object> 予報対象地域の時系列で表現した予報を記載する #4. timeSeries |
| 5. | forecastAddition | Object 季節予報の付加事項を記載する #5. forecastAddition |
2. target
電文が対象とする全国・地方予報区等を記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 2._1. | code | String<Integer> 全国・地方予報区等の地域コード | |
| 2._2. | name | String 全国・地方予報区等の地域名 |
3. season
各期間を通した地域の予報内容、予想確率・確率文等を記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 3._1. | type | String季節予報 で固定 | |
| 3._2. | period | Object 予報・観測基点時刻 | |
| 3._2._1. | dateTime | Object 予報・観測基点時刻 | |
| 3._2._1._1. | value | ISO8601Time 日時（日までが有効） | |
| 3._3._1._2. | validFormat | String 日時が有効な範囲をフォーマットとして記載する | |
| 3._3._2. | duration | String 基点時刻からの期間の長さを、 ISO8601 の Time intervals 形式で表す | |
| 3._3._3. | name | String 予報期間の文字表現を記載する | |
| 3._4. | items | Array<Object> 概況文・特徴のある確率文、予報要素・確率値を各地域の各要素毎に記載する #3. 4. item |
3. 4. item
概況文・特徴のある確率文、予報要素・確率値を各地域の各要素毎を記載します。
概況文・特徴のある確率 文の場合
この item 要素は、1つのみ items の最初に記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 3._4._1.? | kinds | 概況文・特徴のある確率文がある場合 | Array<Object> 概況文・特徴のある確率文を記載する、要素は1つのみ |
| 3._4._1._1. | type | String出現の可能性が最も大きい天候と、特徴のある気温、降水量等の確率 で固定 | |
| 3._4._1._2. | summaries | Array<Object> | |
| 3._4._1._2._1.? | text | 情報による | String |
| 3._4._1._2._2. | significances | Array<Object> | |
| 3._4._1._2._2._1. | type | String気温、降水量、日照時間 または 降雪量 | |
| 3._4._1._2._2._2. | value | String | |
| 3._4._2.? | zones | 概況文・特徴のある確率文がある場合 | Array<Object> 対象の地域、要素は1つのみ |
| 3._4._2._1. | code | String<Integer> 全国・地方予報区等の地域コード | |
| 3._4._2._2. | name | String 全国・地方予報区等の地域名 | |
| 3._4._3.? | condition | 概況文・特徴のある確率文がない場合 | String要素なし と記載する |
予報要素・確率値の場合
この item 要素は、0個以上 items の2番目以降に記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 3._4._1. | kinds | Array<Object> 予報要素・確率値を記載する、要素は1つのみ | |
| 3._4._1._1. | type | String地域・期間平均平年偏差各階級の確率 で固定 | |
| 3._4._1._2. | probabilities | Array<Object> | |
| 3._4._1._2._1. | type | String気温、降水量、日照時間 または 降雪量 | |
| 3._4._1._2._2. | belowNormal | Object; | |
| 3._4._1._2._2._1. | type | String平年より低い確率 または 平年より少ない確率 | |
| 3._4._1._2._2._2. | unit | String% で固定 | |
| 3._4._1._2._2._3. | value | String<Integer> | |
| 3._4._1._2._2._4. | significant | 特徴のある確率である場合 | Boolean |
| 3._4._1._2._2. | norma | Object; | |
| 3._4._1._2._2._1. | type | String平年並みの確率 で固定 | |
| 3._4._1._2._2._2. | unit | String% で固定 | |
| 3._4._1._2._2._3. | value | String<Integer> | |
| 3._4._1._2._2._4. | significant | 特徴のある確率である場合 | Boolean |
| 3._4._1._2._2. | aboveNormal | Object; | |
| 3._4._1._2._2._1. | type | String平年より高い確率 または 平年より多い確率 | |
| 3._4._1._2._2._2. | unit | String% で固定 | |
| 3._4._1._2._2._3. | value | String<Integer> | |
| 3._4._1._2._2._4. | significant | 特徴のある確率である場合 | Boolean |
| 3._4._2. | zones | Array<Object> 対象の地域、要 素は1つのみ | |
| 3._4._2._1. | code | String<Integer> 全国・地方予報区等の地域コード | |
| 3._4._2._2. | name | String 全国・地方予報区等の地域名 |
4. timeSeries
各地域の予報内容、予想確率・確率文等を時系列で記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 4._1. | timeSeries | Array<Object> 各地域の予報内容、予想確率・確率文等を時系列で記載する、要素は1つのみ | |
| 4._1._1. | timeDefines | Array<Object> 全ての予想期間を示すとともに、対応する要素の個々の時刻定義を記載する #4. 1. 1. timeDefine | |
| 4._1._2. | items | Array<Object> 予報内容、予想確率・確率文等の内容と地域を記載する #4. 1. 2. item |
4. 1. 1. timeDefine
時系列の予報で参照番号として用いるための時刻 ID をフィールド timeId で記述し、基点時刻、対象期間、時刻定義の内容を記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 4._1._1._1. | timeId | String<Integer> 時刻ID | |
| 4._1._1._2. | dateTime | ISO8601Time 予想する基準日時 | |
| 4._1._1._3. | duration | String 基準日時からの予想時間の幅を、 ISO8601 の Time intervals 形式で表す | |
| 4._1._1._4. | name | String 時刻定義の内容 |
4. 1. 2. item
概況文・特徴のある確率文、予報要素・確率値を各地域の各要素毎を記載します。
概況文・特徴のある確率文の場合
この item 要素は、1つのみ items の最初に記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 4._1._2._1.? | kinds | Array<Object> 概況文・特徴のある確率文を記載する、要素は1つのみ | |
| 4._1._2._1._1. | type | String出現の可能性が最も大きい天候と、特徴のある気温、降水量等の確率 で固定 | |
| 4._1._2._1._2. | summaries | Array<Object> | |
| 4._1._2._1._2._1. | refId | String<Integer> | |
| 4._1._2._1._2._2.? | text | 情報による | String |
| 4._1._2._1._2._3. | significances | Array<Object> | |
| 4._1._2._1._2._3._1. | type | String気温、降水量、日照時間 または 降雪量 | |
| 4._1._2._1._2._3._2. | value | String | |
| 4._1._2._2.? | zones | Array<Object> 対象の地域、要素は1つのみ | |
| 4._1._2._2._1. | code | String<Integer> 全国・地方予報区等の地域コード | |
| 4._1._2._2._2. | name | String 全国・地方予報区等の地域名 |
予報要素・確率値の場合
この item 要素は、0個以上 items の2番目以降に記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 4._1._2._1. | kinds | Array<Object> 予報要素・確率値を記載する、要素は1つのみ | |
| 4._1._2._1._1. | type | String地域・期間平均平年偏差各階級の確率 で固定 | |
| 4._1._2._1._2. | probabilities | Array<Object> | |
| 4._1._2._1._2._1. | refId | String<Integer> | |
| 4._1._2._1._2._2. | type | String気温、降水量、日照時間 または 降雪量 | |
| 4._1._2._1._2._3. | belowNormal | Object; | |
| 4._1._2._1._2._3._1. | type | String平年より低い確率 または 平年より少ない確率 | |
| 4._1._2._1._2._3._2. | unit | String% で固定 | |
| 4._1._2._1._2._3._3. | value | String<Integer> | |
| 4._1._2._1._2._3._4. | significant | 特徴のある確率である場合 | Boolean |
| 4._1._2._1._2._4. | norma | Object; | |
| 4._1._2._1._2._4._1. | type | String平年並みの確率 で固定 | |
| 4._1._2._1._2._4._2. | unit | String% で固定 | |
| 4._1._2._1._2._4._3. | value | String<Integer> | |
| 4._1._2._1._2._4._4. | significant | 特徴のある確率である場合 | Boolean |
| 4._1._2._1._2._5. | aboveNormal | Object; | |
| 4._1._2._1._2._5._1. | type | String平年より高い確率 または 平年より多い確率 | |
| 4._1._2._1._2._5._2. | unit | String% で固定 | |
| 4._1._2._1._2._5._3. | value | String<Integer> | |
| 4._1._2._1._2._5._4. | significant | 特徴のある確率である場合 | Boolean |
| 4._1._2._2. | zones | Array<Object> 対象の地域、要素は1つのみ | |
| 4._1._2._2._1. | code | String<Integer> 全国・地方予報区等の地域コード | |
| 4._1._2._2._2. | name | String 全国・地方予報区等の地域名 |
5. forecast addition
季節予報の付加事項を記載します。
| 階層 | フィールド | 出現条件 | 説明 |
|---|---|---|---|
| 5._1. | nextForecastSchedules | Array<Object> 季節予報の次回発表予定 | |
| 5._1.‗1. | type | String１か月予報、３か月予報、暖候期予報 または 寒候期予報 | |
| 5._1.‗2. | text | String 季節予報の次回発表予定の平文表現を記載する | |
| 5._1.‗3. | dateTime | ISO8601Time 季節予報の次回発表予定の日時を記載する | |
| 5._2. | scheduleNotice | String|Null 最新資料利用の注意喚起等を記載する、ない場合は Null | |
| 5._3. | additionalNotice | String|Null その他お知らせ・特記事項を記載する、ない場合は Null |
この電文で取り扱うコード類
コードは、気象庁防災情報XMLフォーマット コード表 AreaForecast に記載があります。
サンプル
- VPZK50 - 全般暖候期予報
- VPZK50 - 全般寒候期予報
- VPZK50 - 全般暖候期予報
- VPZK50 - 全般１か月予報
- VPZK50 - 全般３か月予報
- VPZK50 - 全般３か月予報
- VPCK50 - 北海道地方暖候期予報
- VPCK50 - 北海道地方寒候期予報
- VPCK50 - 北海道地方１か月予報
- VPCK50 - 北海道地方３か月予報
- VPCK50 - 北海道地方３か月予報
- VPCK50 - 関東甲信地方３か月予報
- VPCK50 - 中国地方暖候期予報
- VPCK50 - 中国地方暖候期予報
- VPCK50 - 九州南部・奄美地方暖候期予報
- VPCK50 - 九州南部・奄美地方暖候期予報
- VPCK50 - 沖縄地方暖候期予報