農作物名ガイドライン（GL3）取得API：Get/{CropNameId}
- 公開日
- 更新日 2025-03-18
利用条件
概要
API名称
カテゴリー
説明
内閣官房IT総合戦略室が提供する、農作物名ガイドライン(GL3)のデータです。農作物名ガイドライン(GL3)APIから粗飼料の名称も入手可能です。
本APIの利用にあたっては利用規約への同意の上、別途利用申請が必要です。
ご利用の際は以下の「農業データ連携基盤（WAGRI）利⽤・変更申請ページ」からご申請をお願い申し上げます。
https://wagri-subscription.db.naro.go.jp/ords/r/prd/subscription/pre-registration
添付ファイル
■マニュアル
■利用規約
■コード一覧
関連メソッド
データの更新頻度
リクエスト
新URL
New!
https://api.wagri2.net/MaffOpenData/others/GuidelinesForCropNames/Get/{CropNameId}
旧URL（2025年度末で終了予定）
https://api.wagri.net/API/MaffOpenData/Private/GuidelinesForCropNames/Get/{CropNameId}
説明
登録されている農作物名ガイドライン(GL3)のデータを主キーにより１件指定して取得できます。 主キーはJSON形式のレスポンス情報に含まれており、Odataによるフィルター検索で取得できます。 主キー以外の条件抽出に関しても、Odataで取得可能です。
HTTPメソッド
パラメータ
URLデータ定義
GuidelinesForCropNames(PK)
| 名称 | 値 | 型 | 値の説明 |
|---|---|---|---|
| CropNameId | 農作物名ID | string | Required Max Length: 8 |
URL説明
JSON型式のレスポンスに含まれており、データ1件を特定するための一意のキーとなります。
新呼出例
New!
https://api.wagri2.net/MaffOpenData/others/GuidelinesForCropNames/Get/04040400
旧呼出例（2025年度末で終了予定）
https://api.wagri.net/API/MaffOpenData/Private/GuidelinesForCropNames/Get/04040400
レスポンス
レイアウト
レスポンスデータ定義
GuidelinesForCropNames
| 名称 | 値 | 型 | 値の説明 |
|---|---|---|---|
| CropNameId | 農作物名ID | string | Required Max Length: 8 |
| LargeCategoryCode | 大分類コード | string, null | Max Length: 2 |
| LargeCategoryName | 大項目名 | string, null | Max Length: 30 |
| MediumCategoryCode | 中分類コード | string, null | Max Length: 4 |
| MediumCategoryName | 中分類名 | string, null | Max Length: 30 |
| CropName | 農作物名 | string, null | Max Length: 30 |
| WAGRICategoryCode1 | WAGRI分類1コード | string, null | Max Length: 6 |
| WAGRICategoryCode2 | WAGRI分類2コード | string, null | Max Length: 26 |
| FruitAndVegetablesNameCode | 青果物統一品名コード | string, null | Max Length: 5 |
| AGROVOCId | AGROVOC_ID | string, null | Max Length: 32 |
| CropVocabularyURI | 農作物語彙体系URI | string, null | Max Length: 500 |
| Thesaurus | 同義語 | string, null | Max Length: 8833 |
| ConcreteExample | 具体例 | string, null | Max Length: 8833 |
| HarvestingPart | 収穫部位 | string, null | Max Length: 100 |
| Properties | 属性項目 | string, null | Max Length: 500 |
レスポンス説明
GuidelinesForCropNames
レスポンス例
{
"CropNameId": "04040400",
"LargeCategoryCode": "04",
"LargeCategoryName": "果樹類",
"MediumCategoryCode": "0404",
"MediumCategoryName": "果樹類",
"CropName": "ピタヤ",
"WAGRICategoryCode1": "NSM009",
"WAGRICategoryCode2": "NSM0090004500000",
"FruitAndVegetablesNameCode": "49401",
"AGROVOCId": null,
"CropVocabularyURI": "https://www.cavoc.org/cvo/ns/3/C529",
"Thesaurus": "ドラゴンフルーツ",
"ConcreteExample": "ホワイトピタヤ,レッドピタヤ,ゴールデンピタヤ",
"HarvestingPart": "果実",
"Properties": null,
"id": "API~MaffOpenData~Private~GuidelinesForCropNames~1~04040400",
"_Owner_Id": "00000000-0000-0000-0000-000000000000"
}
ステータスコード
| コード | 名称 | 値の説明 |
|---|---|---|
| 400 | Bad Request | リクエストが不正です。 |
| 403 | Forbidden | リソースのアクセスが禁止されています。 |
| 500 | Internal Server Error | サーバー内部でエラーが発生しました。 |
| 401 | Unauthorized | 認証情報が不正です。 |
サンプルソースコード
プログラム記述例（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）
ー