緩効性肥料養分供給 API:FertilizerSupplyInformation
- 更新日 2024-10-21
概要
API名称
説明
肥料の略称、日平均温度などを入力することにより、肥料施用日からの養分の積算供給率を日単位で計算する。
データの更新頻度
カテゴリー
添付ファイル
関連メソッド
- ー
リクエスト
URL
https://api.wagri.net/API/Individual/NIAES/FertilizerSupply/FertilizerSupplyInformation
説明
肥料の略称、日平均温度などを入力することにより、肥料施用日からの養分の積算供給率を日単位で計算する。
HTTPメソッド
パラメータ
キー名 |
説明 |
データ型 |
備考 |
Fertilizer |
肥料の略称または条件 |
String |
1)空(無)のとき、APIの説明文を出力します。 2)“list” のとき、肥料の略称の一覧を出力します。 3)肥料の略称のとき、その肥料について、施用日からの養分の積算供給率(1=100%)を日単位で計算します。 |
Days |
肥料を施用してからの計算日数 |
Number |
指定が無い場合、TmeanListの個数となります。TmeanListの個数と一致しない場合はエラーとなります。 |
TmeanList |
肥料を施用してからの日々の温度日平均(℃) |
Number[n] |
肥料を施用してから計算する日数分[n]の値が必要です。 |
TrangeList |
肥料を施用してからの日々の温度日較差(℃) |
Number[n] |
TmeanListと同じ日数分[n]の値が必要です。省略時は全て0となり、部分的な省略は不可となります。実用上は省略でも構いません。 |
WaterMPaList |
肥料を施用してからの日々の水分ポテンシャル(MPa) |
Number[n] |
TmeanListと同じ日数分[n]の値が必要です。負の値となります(-0.1MPaは「-0.1」)。省略時は全て0となり、部分的な省略は不可となります。作物が生長阻害を起こす(pF3 ≒ −0.1MPa)ほど著しく乾燥しない限り影響は小さいので、実用上は省略でも構いません。 |
呼出例
レスポンス
レイアウト
キー名 |
説明 |
データ型 |
備考 |
CumList |
肥料について施用日からの養分の積算供給率(1=100%) |
Number[n] |
個数[n]はTmeanListの個数と同じです。 |
Help |
説明文 |
String |
Fertilizerの入力値が空や不適切な場合、説明文を出力します。 それ以外は、空(無)となります。 |
FertilizerList |
肥料の略号の一覧 |
String[]/String |
Fertilizerの入力値が”list”のとき、肥料の略号の一覧を出力します。それ以外は、空(無)となります。 |
ExitCode |
処理結果コード |
Number |
問題が無ければ0、問題があればそれ以外の値を与えます(下表参照)。 |
Message |
処理結果メッセージ |
String |
問題が無ければ、空(無)、問題があればその旨のメッセージを与えます(下表参照)。 |
レスポンス例
1)Helpの出力: 入力: { "Fertilizer":"" } 出力: { "CumList": [], "ExitCode": 0, "FertilizerList": "", "Help": "This API calculates the cumulated ratios of supplied nutrient from a fertilizer for each day since the fertilizer is applied.\\n\\nInput parameters (JSON) are the following.\\n\"Fertilizer\" (string) is the following:\\n 1) When nothing (or \"\") is inputted, this help sentences are outputted.\\n 2) When \"list\" is inputted, the list of fertilizer abbreviation is outputted.\\n 3) When a fertilizer abbreviation in the list of fertilizer abbreviations is inputted, the cumulated ratios of supplied nutrient from the fertilizer for each day for the calculation period are outputted.\\n\"Days\" (number) is the number of days for calculation since the fertilizer is applied. It can be omitted, in which case it is the number of values in \"TmeanList\".\\n\"TmeanList\" (number [n]) is the list of daily mean temperatures of each day for the calculation period (n = Days) since the fertilizer is applied.\\n\"TrangeList\" (number [n]) is the list of daily range temperatures of each day for the calculation period (n = Days) since the fertilizer is applied.This list can be omitted, in which case all values in the list are 0.\\n\"WaterMPaList\" (number [n]) is the list of daily water potentials (MPa) of each day for the calculation period (n = Days) since the fertilizer is applied.This list can be omitted, in which case all values in the list are 0.\\n\\nOutput data (JSON) are the following.\\n\"Help\" (string) has this help sentences when they are outputted.\\n\"FertilizerList\" (string) has the list of fertilizer abbreviation when it is outputted.\\n\"CumList\" (number [n]) has the list of the cumulated ratios of supplied nutrient from a fertilizer for each day since the fertilizer is applied.\\n\"ExitCode\" (number) has the number that indicates the result of success or failure of this calculation or the kind of error.\\n\"Message\" (string) has the message that indicates the result of success or failure of this calculation or the kind of error.", "Message": "" } 2)肥料の略称リストの出力 入力: { "Fertilizer":"list" } 出力: { "CumList": [], "ExitCode": 0, "FertilizerList": [ "L10", "L15", "L20", "L30", "L40", "L50", "L60", "L70", "L80", "L90", "L100", "L110", "L120", "L130", "L140", "L150", "L160", "L170", "L180", "L190", "L200", "L210", "L220", "L230", "L240", "L250", "L260", "L270", "L280", "L290", "L300", "S10", "S15", "S20", "S30", "S40", "S50", "S60", "S70", "S80", "S90", "S100", "S110", "S120", "S130", "S140", "S150", "S160", "S170", "S180", "S190", "S200", "S210", "S220", "S230", "S240", "S250", "S260", "S270", "S280", "S290", "S300" ], "Help": "", "Message": "" } 3)肥料「S20」を施肥してから3日間の養分供給比率の計算(入力は日平均温度のみ) 入力: { "Fertilizer":"S20", "TmeanList":[6.3,6.3,6.2] } 出力: { "CumList": [ 0.001454326843936874, 0.0015372881182378585, 0.0016239826610862445 ], "ExitCode": 0, "FertilizerList": "", "Help": "", "Message": "" } 4)肥料「S20」を施肥してから3日間の養分供給比率の計算(入力は日平均温度、温度日較差、水分ポテンシャルを使用) 入力: { "Fertilizer":"S20", "Days":3, "TmeanList":[6.3,6.3,6.2], "TrangeList":[9.7,9.7,9.6], "WaterMPaList":[-0.1,-0.1,-0.1] } 出力: { "CumList": [ 0.0014587348837685813, 0.0015466207541964835, 0.0016386271665538058 ], "ExitCode": 0, "FertilizerList": "", "Help": "", "Message": "" }
ステータスコード
ExitCode |
Message |
説明 |
0 |
“” |
正常処理 |
4 |
“Calculation failure” |
計算処理失敗 |
5 |
“Unexpected error” |
予期しないエラーが発生 |
1 |
“Wrong input: “ |
入力パラメータ不正: 具体的には下記の情報を付加 |
|
“Wrong key” |
間違ったキーが含まれる |
|
“TmeanList is needed” |
パラメータTmeanListが指定されない |
|
“No matching fertilizer abbreviation” |
指定した肥料の略号が存在しない ※Fertilizerに期待外の文字列を設定した場合、Helpメッセージも同時に出力 |
|
“Too many days of calculation (>4096)” |
計算日数が上限を超えている (上限は4096日) |
|
“Inappropriate number of data in TmeanList” |
計算日数が温度日平均のデータ数と一致しない |
|
“Inappropriate number of data in TrangeList” |
TrangeListのデータ数が温度日平均のデータ数と一致しない |
|
“Inappropriate number of data in WaterMPaList” |
WaterMPaListのデータ数が温度日平均のデータ数と一致しない |
|
“Wrong type of data for Days” |
計算日数の型エラー |
|
“Wrong type of data for TmeanList” |
温度日平均の型エラー |
|
“Wrong type of data for TrangeList” |
温度日較差の型エラー |
|
“Wrong type of data for WaterMPaList” |
水分ポテンシャルの型エラー |