NARO栽培管理支援API20 共通 作付計画支援: CropRotationCalendar
- 公開日
- 更新日 2026-01-26
利用条件
概要
API名称
カテゴリー
説明
農業経営の大規模化により、作付け体系が複雑化しています。
水稲、麦、大豆、飼料用とうもろこしの発育予測モデルを組み合わせて、作業競合を回避した作業カレンダーを提示することにより、作付計画を支援します。
最大3年5作(3年間・5シーズン:夏-冬-夏-冬-夏)の作付けが入力でき、各シーズンについて最大20作目(作物・品種の組み合わせ)の計算が可能です。
利用可能な作目・品種は、水稲、小麦、大豆、とうもろこしの発育予測API(API01, API09, API11,API26)に対応します。
添付ファイル
データの更新頻度
リクエスト
新URL
New!
https://api.wagri2.net/naro-niaes/prediction/CropRotationCalendar
旧URL(2025年度末で終了予定)
https://api.wagri.net/API/Individual/NIAES/AGMIS/CropRotationCalendar
説明
メソッドを呼び出す際のHTTPリクエストのボディは、JSON 形式です。リクエストボティは、栽培地の緯度・経度、作付ける作物・品種、栽培面積などで構成されます。パラメータ値にもとづき、出穂期などの発育予測情報と、耕起、作付け、収穫等にかかる日付情報を返します。
HTTPメソッド
パラメータ
API入力パラメーター
| 物理名 | 変数の種類 | 必須か |
| lat | 緯度 | 〇 |
| lon | 経度 | 〇 |
| area | 総圃場面積(ha) | 〇 |
| simulation_type | simulationメソッドの選択 | ー |
| master_id | 読み込むマスター行の選択 | ー |
| start_year | 計算開始年 | ー |
| season_start | 各シーズンの作付け開始希望日 | △ |
| crop_type | 作付けごとの作物の種別値 | △ |
| crop_by_id | 作付けごとの品種ID | △ |
| area_each_crop | 作付けごとの栽培面積 | △ |
| start_each_crop | 個別の作付け希望日 | ー |
| plow_each_crop | 個別の事前耕起の有無 | ー |
| rate_plowing_transplantrice | 移植水稲・事前耕起の作業能率 | ー |
| rate_puddling_transplantrice | 移植水稲・代掻きの作業能率 | ー |
| rate_transplanting_rice | 移植水稲・移植の作業能率 | ー |
| rate_harvesting_rice | 水稲・収穫の作業能率 | ー |
・〇は入力必須パラメータ、△は当該シーズン・作付け番号に作付け希望がある場合に必須のパラメータです。
・ここに掲載されたパラメータの他に、作業能率や、作業の実施の可否に関する限界降水量パラメータについて、作物・作業ごとに入力可能です。詳細は、別途申請者に配布される入出力表を参照してください。
API出力パラメータ
| 物理名 | 論理名 | 型 | |
| manage_season[m]_crop[n] | 辞書型{key=作業 :各DOYにおける作業実施時間割合} | dict | |
| plowing | 耕起 | number | |
| puddling | 代掻き | number | |
| planting | 植え付け(播種・移植) | number | |
| harvesting | 刈り取り | number | |
| phenology_season[m]_crop[n] | 辞書型{key=1~6の数字 :作付け日に対応するDOY} | dict | |
| 1 | 作付け日 | number | |
| 2 | 出芽:共通 | number | |
| 3 | 幼穂形成期:水稲,茎立ち期:麦,子実肥大始:大豆 | number | |
| 4 | 成熟期:共通 | number | |
| 5 | 出穂期:水稲・麦 | number | |
| 6 | 開花期:麦・大豆,絹糸抽出期:トウモロコシ | number | |
| cal_season[m]_crop[n] | 配列(ベクトル) | ||
| 1 | シーズン番号 | number | |
| 2 | シーズンごとの作付け番号 | number | |
| 3 | 耕起始め | string | |
| 4 | 耕起終了 | string | |
| 5 | 代掻き始め | string | |
| 6 | 代掻き終了 | string | |
| 7 | 播種・移植始め | string | |
| 8 | 播種・移植終了 | string | |
| 9 | 出芽期始め | string | |
| 10 | 出芽期終了 | string | |
| 11 | 幼穂形成期(水稲)茎立ち期(麦)子実肥大期(大豆)始め | string | |
| 12 | 幼穂形成期(水稲)茎立ち期(麦)子実肥大期(大豆)終了 | string | |
| 13 | 成熟始め | string | |
| 14 | 成熟終了 | string | |
| 15 | 出穂始め | string | |
| 16 | 出穂終わり | string | |
| 17 | 開花期始め、 絹糸抽出期始め(トウモロコシ) | string | |
| 18 | 開花期終了、 絹糸抽出期終了(トウモロコシ) | string | |
| 19 | 収穫始め | string | |
| 20 | 収穫終了 | string | |
| alert_code | 下記3項目×可変長 | 2次元配列 | |
| シーズン番号 | 配列:number | ||
| シーズンごとの作付け番号 | 配列:number | ||
| アラート番号 | 配列:string | ||
| slack_period | 作業間期 | 配列:number | |
| rate_plowing_transplantrice | 作業能率・移植水稲・事前耕起 | 配列:number | |
| rate_plowing_floodfield_directseedrice | 作業能率・湛直水稲・事前耕起 | 配列:number | |
| rate_plowing_dryfield_directseedrice | 作業能率・乾直水稲・事前耕起 | 配列:number | |
| rate_puddling_transplantrice | 作業能率・移植水稲・代掻き | 配列:number | |
| rate_puddling_floodfield_directseedrice | 作業能率・湛直水稲・代掻き | 配列:number | |
| rate_transplanting_rice | 作業能率・移植水稲・移植 | 配列:number | |
| rate_sowing_floodfield_directseedrice | 作業能率・湛直水稲・播種 | 配列:number | |
| rate_sowing_dryfield_directseedrice | 作業能率・乾直水稲・播種 | 配列:number | |
| rate_harvesting_rice | 作業能率・水稲・収穫 | 配列:number | |
| rate_plowing_wheat | 作業能率・麦・事前耕起 | 配列:number | |
| rate_sowing_wheat | 作業能率・麦・播種 | 配列:number | |
| rate_harvesting_wheat | 作業能率・麦・収穫 | 配列:number | |
| rate_plowing_soy | 作業能率・大豆・事前耕起 | 配列:number | |
| rate_sowing_soy | 作業能率・大豆・播種 | 配列:number | |
| rate_harvesting_soy | 作業能率・大豆・収穫 | 配列:number | |
| rate_plowing_corn | 作業能率・トウモロコシ・事前耕起 | 配列:number | |
| rate_sowing_corn | 作業能率・トウモロコシ・播種 | 配列:number | |
| rate_harvesting_corn | 作業能率・トウモロコシ・収穫 | 配列:number | |
新呼出例
New!
{
"lat": 36.007,
"lon": 140.021,
"area": 150.0,
"season_start": [
"05-01",
"11-10",
"05-01",
"11-10",
"05-01"
],
"crop_type": [
[
0,
0,
0,
0,
2
],
中略
"crop_by_id": [
[
11,
12,
19,
34,
2
],
中略
"area_each_crop": [
[
15.0,
15.0,
20.0,
8.0,
15.0 ],
中略
"start_each_crop": [
[
"04-10",
null,
null,
null,
"06-15"
],
中略
]
}
ー
旧呼出例(2025年度末で終了予定)
{
"lat": 36.007,
"lon": 140.021,
"area": 150.0,
"season_start": [
"05-01",
"11-10",
"05-01",
"11-10",
"05-01"
],
"crop_type": [
[
0,
0,
0,
0,
2,
null,
null,
null,
null,
null
],
中略
"crop_by_id": [
[
11,
12,
19,
34,
2,
null,
null,
null,
null,
null
],
中略
"area_each_crop": [
[
15.0,
15.0,
20.0,
8.0,
15.0,
null,
null,
null,
null,
null
],
中略
"start_each_crop": [
[
"04-10",
null,
null,
null,
"06-15",
null,
null,
null,
null,
null
],
中略
]
}
レスポンス
レイアウト
HTTPレスポンスのボディはJSON形式となります。
各作業(耕起、代掻き、作付け、刈取り)の各日の作業時間割合、各作物の作付け日ごとの主要発育ステージの暦日、各作業と発育ステージの開始/終了日と作業カレンダーのアラート番号などが出力されます。
レスポンス例
{
"manage_season1_crop1": {
"plowing": [
[
106,
107,
108,
109,
110,
111,
112,
113,
114,
115
],
[
1,
1,
1,
1,
1,
1,
1,
1,
1,
0.489353
]
],
"puddling": [
[
116,
117,
118,
119
],
[
0.672561,
1,
1,
1
]
],
"planting": [
[
120,
121,
122,
123,
124,
125,
126,
127,
128
],
[
1,
1,
1,
1,
1,
1,
1,
1,
0.578589
]
],
"harvesting": [
[
230,
231,
232,
233,
234,
235,
236,
237,
238,
239,
240,
241,
242,
243
],
[
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
0.672658
]
]
},
以下省略
}
ステータスコード
| コード | 名称 | 値の説明 |
| 200 | OK | 処理成功 |
| 400 | Bad Request | HTTP リクエストのデータが不正 |
| 401 | Unauthorized | 認証エラー |
| 403 | Forbidden | アクセス権限がない |
| 404 | Not Found | HTTP リクエストで指定されたメソッドが存在しない |
| 500 | Internal Server Error | その他のエラー |
サンプルソースコード
プログラム記述例(WAGRI共通)
import requests
url = "https://api.wagri.net/API/Public/AgriculturalLand/SearchByCityCode"
payload = {
'CityCode': '432041'
}
headers = {
'X-Authorization': 'アクセストークン',
}
response = requests.get(url, headers=headers, params=payload)
print(response.text)
プログラム記述例(個別API)
付属資料を参照

