キーワード検索

有機質資材肥効見える化API（窒素肥効）：水田版

公開日 2025-05-31

更新日 2026-06-29

提供ベンダー

農研機構：九州沖縄農業研究センター

システム名

有機質資材肥効見える化API

利用条件

有償オプションAPI（申込必要）

概要

API名称

有機質資材肥効見える化(水田版）API（窒素肥効）

説明

資材の種類・量・特性、施用期間の施用地点の土壌温度・土壌水分などを入力データとして受け取り、施用日からの日単位の窒素（N）肥効量及びその積算値を返す。APIに実装した数理モデルは入力情報に基づき日単位で異なる肥効量を算出する。

添付ファイル

データの更新頻度

リクエスト

URL

https://api.wagri2.net/naro-niaes/pesticide/FertilizerEffectInformationN

説明

資材の種類・量・特性、施用期間の施用地点の土壌温度・土壌水分などを入力データとして受け取り、水田における施用日からの日単位の窒素（N）肥効量及びその積算値を返す。APIに実装した数理モデルは入力情報に基づき日単位で異なる肥効量を算出する。

HTTPメソッド

POST

パラメータ

キー名	説明	データ型	備考
StartDate	施用日	String	必須　(日付、例：”20220221″)
WaterDate	入水日	String	必須　(日付、例：”20220221″)
EndDate	収穫日	String	必須　(日付、例：”20220221″)
MaterialAmount	資材の施用量（現物重量）	Number	必須　単位は(kg) 施用する資材からの肥効を算出するため、施用量は面積当たりに限定されない。
MaterialType	資材の種類	Number	必須 1牛ふん堆肥、2豚ぷん堆肥、3鶏ふん堆肥、4植物油かす、5魚かす、7米ぬか、14市販混合有機肥料なお、１～３は家畜ふん堆肥、４～７、１４は市販資材
MaterialAtt	資材の特性（複数）	object	必須　※MaterialAttの通り
Coefficient	モデルの係数・定数（複数）	object	必須　※Coefficientの通り
Latitude	緯度	Number	SoilTempList, SoilWaterListが未入力時は必須 SoilTempList, SoilWaterListが入力時は不要
Longitude	経度	Number	SoilTempList, SoilWaterListが未入力時は必須 SoilTempList, SoilWaterListが入力時は不要
SoilTempList	土壌温度リスト	Number[n]	任意。ただし、未入力時はLatitude, Longitude要入力 n=収穫日 – 施用日 + 1
SoilWaterList	土壌水分リスト	Number[n]	任意。ただし、未入力時はLatitude, Longitude要入力 n=収穫日 – 入水日施用日から入水前日までの値を入力し、入水日の値は入力しない。

※MaterialAtt

サブキー名	説明	データ型	備考
MC	資材の含水率	Number	単位は（%）、0を入力可とする。資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。
ADSON	ADSON窒素量	Number	単位は乾物あたりのmg-N/g、資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。
TN	資材の全窒素含有率	Number	単位は（%）、資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。
Nm	資材の無機態窒素含有率	Number	単位は（%）、資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。

※Coefficient

サブキー名	説明	データ型	備考
a1	モデル式パラメーターα1	Number	資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。
Q10	地温関連の係数	Number	資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。
b	土壌水分関連の係数	Number	資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。
kd	資材のモデル式パラメーターk	Number	資材の種類に応じたデフォルト値も選択できる。入力値なしの場合はnullとして、そのデフォルト値を利用する。

呼出例

ー

レスポンス

レイアウト

キー名	説明	データ型	備考
ExitCode	処理結果コード	Number	※ExitCodeとMessageの通り
StartDate	施用日	String	入力値と同様(正常終了以外の場合は空白)
WaterDate	入水日	String	入力値と同様（正常終了以外の場合は空白）
EndDate	収穫日	String	入力値と同様(正常終了以外の場合は空白)
DailyList	施用日から収穫前日までの日単位の肥効	Number[n]	単位は施用量あたりのkg-N 、 [n]:n はデータ数 = 収穫日 – 施用日＋１
CumList	施用前と施用日から収穫前日までの肥効の積算値	Number[n]	単位は施用量あたりのkg-N 、 [n]:n はデータ数 = 収穫日 – 施用日　＋１
Message	処理結果メッセージ	String	※ExitCodeとMessageの通り

レスポンス例

出入力例① 

入力値： 
{
"StartDate": "20240503", 
"WaterDate": "20240510", 
"EndDate": "20240514", 
"MaterialAmount": 123, 
"MaterialType": 1, 
"MaterialAtt": { 
    "MC": 33.5, 
    "ADSON": 19.9, 
    "TN": 3.61,
    "Nm": 0.31 
}, 
"Coefficient": { 
    "Q10": 1.47, 
    "a1": 1595,
    "b": 0.189, 
    "kd": 0.016786 
}, 
"Latitude":35.832845022773824, 
"Longitude":140.46307129086765 
} 
出力値： 
{ 
    "ExitCode": 0, 
    "StartDate": "20240503",
    "WaterDate": "20240510", 
    "EndDate": "20240514", 
    "DailyList": [ 
        0.2584124111723678, 
        0.2632424746458326, 
        0.2680512130099664, 
        0.2728352249671581, 
        0.2775910108090447, 
        0.28231588706607585, 
        0.2870074286336999, 
        0.30951135034666954, 
        0.3300628002746264, 
        0.34953820770159494, 
        0.36835826149601536, 
        0.38611118394565663 
    ], 
    "CumList": [ 
        0.2584124111723678, 
        0.5216548858182004, 
        0.7897060988281668, 
        1.062541323795325, 
        1.3401323346043696, 
        1.6224482216704454, 
        1.9094556503041453, 
        2.2189670006508146, 
        2.549029800925441, 
        2.898568008627036, 
        3.2669262701230513,
        3.653037454068708 
     ] 
}

出入力例② 

入力値： 
 { 
    "StartDate": "20240503", 
    "WaterDate": "20240510", 
    "EndDate": "20240514", 
    "MaterialAmount": 123, 
    "MaterialType": 1, 
    "MaterialAtt": { 
        "MC": 33.5, 
        "ADSON": 19.9, 
        "TN": 3.61, 
        "Nm": 0.31 
    }, 
    "Coefficient": { 
        "Q10": 1.47, 
        "a1": 1595, 
        "b": 0.189, 
        "kd": 0.016786 
    }, 
    "SoilTempList": [ 
    18.391,  18.532, 
    18.655,   18.76, 
    18.846,  18.917, 
    18.974, 18.4637, 
    18.028,   17.94, 
    18.0423, 17.9093 
    ], 
    "SoilWaterList": [ 
    0.719, 0.719, 
    0.719, 0.719, 
    0.719, 0.719, 
    0.719 
    ] 
  } 
出力値： 
{ 
    "ExitCode": 0, 
    "StartDate": "20240503", 
    "WaterDate": "20240510", 
    "EndDate": "20240514", 
    "DailyList": [ 
        0.2584124111723678, 
        0.2632424746458326, 
        0.2680512130099664, 
        0.2728352249671581, 
        0.2775910108090447, 
        0.28231588706607585, 
        0.2870074286336999, 
        0.30951135034666954, 
        0.3300628002746264, 
        0.34953820770159494, 
        0.36835826149601536, 
        0.38611118394565663 
    ], 
    "CumList": [ 
        0.2584124111723678, 
        0.5216548858182004, 
        0.7897060988281668, 
        1.062541323795325, 
        1.3401323346043696, 
        1.6224482216704454, 
        1.9094556503041453, 
        2.2189670006508146, 
        2.549029800925441, 
        2.898568008627036, 
        3.2669262701230513, 
        3.653037454068708 
    ] 
}

ステータスコード

ExitCode（値）	Message（内容）
0	正常終了
1	入力パラメータ不正
2	計算処理失敗
9	予期しないエラーが発生

サンプルソースコード

プログラム記述例（WAGRI共通）

import requests
url = "https://api.wagri2.net/API/Public/AgriculturalLand/SearchByCityCode"
payload = {
'CityCode': '432041'
}
headers = {
'X-Authorization': 'アクセストークン',
}
response = requests.get(url, headers=headers, params=payload)
print(response.text)

プログラム記述例（個別API）

前に戻る