農機OpenAPI：devices/{device_id}/locations
- 公開日
- 更新日 2024-10-21
利用条件
概要
API名称
カテゴリー
説明
・本APIでは、WAGRIのゲートウェイ機能を利用することにより、「農林水産データ管理・活用基盤強化事業」において策定された農機OpenAPI仕様に基づき三菱マヒンドラ農機株式会社が準備した農機OpenAPIへの接続を提供します。
・本APIを介して三菱マヒンドラ農機株式会社の農機OpenAPIへ接続し、次の情報を取得することができます。
・登録済み農業機械（トラクタ、コンバイン）のリスト
・農作業を通じて農業機械から取得した稼働データ等
・農機OpenAPI仕様書への参照
農機OpenAPIの仕様を解説した農機OpenAPI仕様書の全文は次のリンク先で参照することができます。
なお、農機OpenAPIの仕様に準拠した各APIの実装状況はサービス提供者によって異なりますので、下記の問合せ先でご確認下さい。
https://www.naro.affrc.go.jp/org/brain/iam/cluster/aboutus/API/index.html#specifications
・問い合わせ先
本APIの使用には、農業データ連携基盤（WAGRI）への利用登録と、三菱マヒンドラ農機株式会社との協議により利用契約等を締結する必要があります。
三菱マヒンドラ農機株式会社 https://www.mam.co.jp/
お問い合わせフォームよりご連絡ください。
添付ファイル
関連メソッド
データの更新頻度
リクエスト
新URL
New!
ー
旧URL（2025年度末で終了予定）
https://api.wagri.net/API/Individual/MAM/AgOpenApi/farm_machinery/v1/devices/{device_id}/locations
説明
デバイスに紐付けられたロケーションレコードのリストを返却する。
・本APIではリクエストパラメータのdevice_id、since、untill、limiitをサポートしています。
・詳細は農機API標準仕様書を参照してください。
HTTPメソッド
パラメータ
詳細は農機API標準仕様書を参照してください。
新呼出例
New!
ー
旧呼出例2025年度末で終了予定）
https://api.wagri.net/API/Individual/MAM/AgOpenApi/farm_machinery/v1/devices/{device_id}/locations
レスポンス
レイアウト
詳細は農機API標準仕様書を参照してください。
レスポンス例
詳細は農機API標準仕様書を参照してください。
ステータスコード
| コード | 名称 | 値の説明 |
| 400 | Bad Request | リクエストが不正です。 |
| 401 | Unauthorized | 認証情報が不正です。 |
| 403 | Forbidden | リソースのアクセスが禁止されています。 |
| 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）
詳細は農機API標準仕様書を参照してください。