Module for FarmTelemetry was added to the SensLog on the SDI4Apps platform. The FarmTelemetry module provides analytical services above tracking data and observations of agricultural machinery. To run full analyses of the FarmTelemetry module, it is necessary to add additional datasets to the database (e.g. LPIS data, cadastral data, route network).
Standard feeder services for inserting observations and positions of agricultural machinery can be used. Implemented analytical functions are described below.
AnalystService
AnalystService provides analytical methods for telemetry. To provide all methods additional data layers need to be stored in DB.
GetWorkOnSites
URL |
/AnalystService?Operation=GetWorkOnSites |
Method |
Functionality |
Format |
GET |
Provides analysis on which sites specified tractor was working during given time frame. |
application/json |
Parameter |
Format |
Role |
unit_id |
Numerical value |
Identifier of unit, mandatory |
user |
Textual value |
Name of user, mandatory |
date |
Textual value |
Date when works are required (ISO 8601 compatible), optional |
from |
Textual value |
Begin date when works are required (ISO 8601 compatible), optional |
to |
Textual value |
End date when works are required (ISO 8601 compatible), optional |
GetTractorUtilization
URL |
/AnalystService?Operation=GetTractorUtilization |
Method |
Functionality |
Format |
GET |
Provides analysis in which ratio was given tractor utilized (standing, working, moving) during given time frame. |
application/json |
Parameter |
Format |
Role |
unit_id |
Numerical value |
Identifier of unit, mandatory |
user |
Textual value |
Name of user, mandatory |
date |
Textual value |
Date when utilization is required (ISO 8601 compatible), optional |
from |
Textual value |
Begin date when utilization is required (ISO 8601 compatible), optional |
to |
Textual value |
End date when utilization is required (ISO 8601 compatible), optional |
GetTractorWorkday
URL |
/AnalystService?Operation=GetTractorWorkday |
Method |
Functionality |
Format |
GET |
Provides analysis what activities specified tractor was performing during given day. Returns list of activities with ID of sites where tractor was moving, ID of connected equipments, spent time, and consumed fuel. |
application/json |
Parameter |
Format |
Role |
unit_id |
Numerical value |
Identifier of unit, mandatory |
user |
Textual value |
Name of user, mandatory |
date |
Textual value |
Date when logbook is required (ISO 8601 compatible), mandatory |
minstop |
Numerical value |
Minimal length of stop in second that is evaluated as break, mandatory |
minwork |
Numerical value |
Minimal length of work in second that is evaluated as work on site, mandatory |
outtime |
Numerical value |
Maximal length of leaving a site in second that is not evaluated as leaving from a site, mandatory |
GetActivitiesFieldOverview
URL |
/AnalystService?Operation=GetActivitiesFieldOverview |
Method |
Functionality |
Format |
GET |
Provides analysis what activities were performed on given site. Returns list of activities grouped by months in year with ID of tractor and ID of connected equipment, spent time, and consumed fuel. |
application/json |
Parameter |
Format |
Role |
site_id |
Numerical value |
Identifier of site or LPIS block, mandatory |
user |
Textual value |
Name of user, mandatory |
GetActivitiesFieldOverviewByPoint
URL |
/AnalystService?Operation=GetActivitiesFieldOverviewByPoint |
Method |
Functionality |
Format |
GET |
Provides analysis what activities were performed on given site defined by interior point. Returns list of activities grouped by months in year with ID of tractor and ID of connected equipment, spent time, and consumed fuel. |
application/json |
Parameter |
Format |
Role |
point |
Textual value |
Pair of coordinates in SRS EPSG:3857 in format “X,Y”, mandatory |
user |
Textual value |
Name of user, mandatory |
GetActivitiesFieldOverviewPeriod
URL |
/AnalystService?Operation=GetActivitiesFieldOverviewPeriod |
Method |
Functionality |
Format |
GET |
Provides analysis what activities were performed on given site defined by interior point during specified time range. Returns list of activities grouped by months in year with ID of tractor and ID of connected equipment, spent time, and consumed fuel. |
application/json |
Parameter |
Format |
Role |
point |
Textual value |
Pair of coordinates in SRS EPSG:3857 in format “X,Y”, mandatory |
user |
Textual value |
Name of user, mandatory |
from |
Textual value |
Begin date when utilization is required (ISO 8601 compatible), optional |
to |
Textual value |
End date when utilization is required (ISO 8601 compatible), optional |
GetFieldFuelSummary
URL |
/AnalystService?Operation=GetFieldFuelSummary |
Method |
Functionality |
Format |
GET |
Provides analysis how much fuel was consumed by activities on given site defined by interior point during specified time range. Returns value of consumed fuel in litres. |
application/json |
Parameter |
Format |
Role |
point |
Textual value |
Pair of coordinates in SRS EPSG:3857 in format “X,Y”, mandatory |
user |
Textual value |
Name of user, mandatory |
from |
Textual value |
Begin date when utilization is required (ISO 8601 compatible), optional |
to |
Textual value |
End date when utilization is required (ISO 8601 compatible), optional |
GetTractorActivePeriod
URL |
/AnalystService?Operation=GetTractorActivePeriod |
Method |
Functionality |
Format |
GET |
Provides analysis if specified tractor was performing any activities during given time range. Returns list of dates when tractor was active. |
application/json |
Parameter |
Format |
Role |
unit_id |
Numerical value |
ID of unit, mandatory |
user |
Textual value |
Name of user, mandatory |
from |
Textual value |
Begin date when utilization is required (ISO 8601 compatible), optional |
to |
Textual value |
End date when utilization is required (ISO 8601 compatible), optional |
GetTractorActivePeriod
URL |
/AnalystService?Operation=GetActiveTractorsPeriod |
Method |
Functionality |
Format |
GET |
Provides analysis which tractors were performing any activities during given time range. Returns list of unit_ids. |
application/json |
Parameter |
Format |
Role |
user |
Textual value |
Name of user, mandatory |
from |
Textual value |
Begin date when utilization is required (ISO 8601 compatible), optional |
to |
Textual value |
End date when utilization is required (ISO 8601 compatible), optional |