NARO栽培管理支援API20 共通 作付計画支援: CropRotationCalendar

提供ベンダー
システム名
NARO栽培管理支援API
利用条件
有償オプションAPI(申込必要)

概要

API名称
API20 共通 作付計画支援
カテゴリー
説明

農業経営の大規模化により、作付け体系が複雑化しています。
水稲、麦、大豆、飼料用とうもろこしの発育予測モデルを組み合わせて、作業競合を回避した作業カレンダーを提示することにより、作付計画を支援します。
最大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メソッド
POST
パラメータ

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)

付属資料を参照

前に戻る
上部へスクロール