NARO栽培管理支援API25 土壌水分恒数推定
- 公開日
- 更新日 2026-07-21
利用条件
有償オプションAPI（申込必要）
概要
API名称
土壌水分恒数推定API
カテゴリー
説明
NARO栽培管理支援API12大豆灌水支援では、圃場容水量、永久しおれ点という２つの土壌物理性パラメータを必要とします。このAPIは転換畑における上記２つのパラメータを緯度・経度等から推定します。この値を使うことでAPI12での土壌パラメータの入力を簡便にします。
添付ファイル
関連メソッド
データの更新頻度
随時
リクエスト
URL
https://api.wagri2.net/naro-niaes/prediction/SoilWaterConstantsEstimation
説明
メソッドを呼び出す際のHTTPリクエストのボディは、JSON 形式です。リクエストボティは、対象圃場の緯度・経度、野外土性、土壌の明度などで構成されます。入力パラメータ値にもとづき、転換畑としたときの圃場容水量および永久しおれ点の推定値を返します。
HTTPメソッド
POST
パラメータ
トウモロコシ発育予測API入力パラメータ
| 物理名 | 論理名（単位） | 型 | 必須か |
|---|---|---|---|
| lat | 圃場緯度（°の10進数） | number | ○ |
| lon | 圃場経度（°の10進数） | number | ○ |
| t_c | 炭素含量（%） | number | － |
| soil_value | 土壌明度（マンセル明度） | number | － |
| clay | 粘土含量（%） | number | － |
| silt | シルト含量（%） | number | － |
| soil_texture | 土性（ISSSの土性区分） | string | － |
トウモロコシ発育予測API出力パラメータ
| 物理名 | 論理名（単位） | 型 | 必須か |
|---|---|---|---|
| theta_FC_estimation | 圃場容水量の推定値 | number | |
| theta_WP_estimation | 永久しおれ点の推定値 | number | |
| category_FC | 圃場容⽔量のキーアウトカテゴリー | number | カテゴリーと⼊⼒データセットの関係は別表を参照 |
| category_WP | 永久しおれ点のキーアウトカテゴリー | number | カテゴリーと⼊⼒データセットの関係は別表を参照 |
| SWC10_Wh | ⽇本⼟壌インベントリーの物理性区分 | integer | 地点に登録値が無い場合は0 |
| is_t_c_estimated | 炭素含量データの由来 | 0 or 1 | 0:実測値、1:⼟壌明度からの推定値 |
| is_clay_silt_estimated | 粒度分布データの由来 | 0 or 1 | 0:実測値、1:土性からの推定値 |
| clay | 粘土含量 | number | 実測値または⼟性からの推定値。0の場 合は粒度データを計算に使わない |
| silt | シルト含量 | number | 実測値または⼟性からの推定値。0の場 合は粒度データを計算に使わない |
| inventory_FC | 日本土壌インベントリーの圃場容水量 | number | |
| inventory_WP | 日本土壌インベントリ―の永久しおれ点 | number |
別表 カテゴリーと⼊⼒データセットの関係
| カテゴリー番号 | 日本土壌インベントリーのデータ） | 粒度分布データ | T-Cデータ |
|---|---|---|---|
| 1 | あり | あり | あり |
| 2 | あり | あり | なし |
| 3 | あり | なし | あり |
| 4 | あり | なし | なし |
| 5 | なし | あり | あり |
| 6 | なし | あり | なし |
| 7 | なし | なし | あり |
| 8 | なし | なし | なし |
呼出例
{
"lat": 36.67619,
"lon": 137.29835,
"soil_value": 4.00,
"soil_texture": "HC"
}
レスポンス
レイアウト
ー
レスポンス例
{
"metadata":{
"title": "土壌水分恒数推定",
"detail": "正常実行されました。",
"instance": "http://api.wagri.net.niaes/v1/soil_water_constants_estimation",
"type": "未定",
"parameter":{"lat": 39.5191, "lon": 140.2612, "soil_value": 4, "soil_texture": "HC", "t_c": null,…}
},
"result":{
"theta_FC_estimation": 43.852821698549945,
"theta_WP_estimation": 19.575805703723702,
"category_WP": 1,
"category_FC": 1,
"SWC10_Wh": 5002,
"is_t_c_estimated": 1,
"is_clay_silt_estimated": 1,
"clay": 50.9,
"silt": 32.8,
"t_c": 1.849,
"inventory_WP": 0.233333333,
"inventory_FC": 0.625
}
}
ステータスコード
| コード | 名称 | 値の説明 |
|---|---|---|
| 200 | OK | 処理成功 |
| 400 | Bad Request | リクエストが不正です。 |
| 401 | Unauthorized | 認証エラー |
| 403 | Forbidden | アクセス権限がない |
| 404 | Not Found | HTTP リクエストで指定されたメソッドが存在しない |
| 401 | Internal Server Error | その他のエラー |
サンプルソースコード
プログラム記述例（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）
ー