GPS
GPS position data format, gps:info message type
| Property | Value |
|---|---|
| Technical Message Type | gps:info |
| Information Type | Telemetry |
| Format | Protobuf |
| Protobuf Schema | agrirouter.technicalmessagetype.GPSList |
| TypeURL | types.agrirouter.com/agrirouter.technicalmessagetype.GPSList |
The gps:info message type is deprecated. For new integrations, send GPS position data in EFDI TimeLog messages (iso:11783:-10:time_log:protobuf) instead.
Overview
The GPS message type carries a list of GPS position records. Each record includes coordinates, altitude, accuracy metrics, and status information.
GPS messages use Protobuf directly: they are not Base64-encoded.
Message Structure
A GPSList message contains a list of GPS position entries, each with the following fields:
| Field | Type | Description |
|---|---|---|
position_north | double | Latitude in WGS84 degrees |
position_east | double | Longitude in WGS84 degrees |
position_up | sint64 | Altitude in millimeters |
position_status | enum | GPS fix quality (see table below) |
pdop | double | Position Dilution of Precision |
hdop | double | Horizontal Dilution of Precision |
number_of_satellites | int32 | Number of satellites used for the fix |
gps_utc_timestamp | timestamp | UTC timestamp of the GPS reading |
field_status | enum | Field context status (see table below) |
Position Status
The position_status enum indicates the quality of the GPS fix.
| Value | Name | Description |
|---|---|---|
| 0 | D_NO_GPS | No GPS signal available |
| 1 | D_GNSS | Standard GNSS fix |
| 2 | D_DGNSS | Differential GNSS fix |
| 3 | D_PRECISE_GNSS | Precise GNSS fix |
| 4 | D_RTK_FINTEGER | RTK fixed integer solution |
| 5 | D_RTK_FLOAT | RTK float solution |
| 6 | D_EST_DR_MODE | Estimated (dead reckoning) mode |
| 7 | D_MANUAL_INPUT | Manually entered position |
| 8 | D_SIMULATE_MODE | Simulated position |
| 9–13 | RESERVED | Reserved for future use |
| 14 | D_ERROR | GPS error state |
| 15 | D_NOT_AVAILABLE | GPS status not available |
Field Status
The field_status enum provides context about the machine's location relative to a field.
| Value | Name | Description |
|---|---|---|
| 0 | FS_UNKNOWN | Unknown (default) |
| 1 | FS_INFIELD | Machine is working in a field |
| 2 | FS_ONROAD | Machine is traveling on a road |
| 3 | FS_OFFROAD | Machine is off-road but not in a field |