GPS Localization⚓︎
When the CloudBoxx is powered on, the ignition is on, or the immobilizer is unlocked, the CloudBoxx tries to determine its GPS position. Whenever a position is available, its internal status is updated.
The GPS position and other current values can be retrieved with:
/devices/{deviceQnr}/status
The position field is omitted from the status object if the CloudBoxx has not been able to get a valid GPS fix since powering on. This can sometimes happen, especially when using the CloudBoxx within a building. In this case, you can for example try placing the antennna outside of a window. After powering on, the CloudBoxx beeps twice if a position was determined.
Meaning of GPS Values⚓︎
Quality⚓︎
The quality indicator shows how GPS fix was determined. In general this value does not provide any information concerning the accuracy of the GPS position and can usually be ignored.
| Value | Quality |
|---|---|
| 0 | No fix |
| 1 | Autonomous GNSS fix |
| 2 | Differential GNSS fix |
| 4 | RTK fixed |
| 5 | RTK |
Satellites in Use⚓︎
A high number of satellites usually leads to a high accuracy of the GPS position. At least 3 satellites are needed to determine the GPS position.
Horizontal Dilution of Precision⚓︎
The important value for the accuracy is the hdop value.
| Value | Rating | Description |
|---|---|---|
| < 1 | Ideal | Highest possible confidence level to be used for applications demanding the highgest possible precision at all times. |
| 1-2 | Excellent | At this confidence level, positional measurements are considered accurate enough to meet all but the most sensitive applications’ requirements. |
| 2-5 | Good | Represents the minimum appropriate confidence level for making business decisions. Positional measurements can be used to make reliable in-route navigation suggestions to the user. |
| 5-10 | Moderate | Positional measurements can be used for calculations but the fix quality could still be improved. A more open view of the sky is recommended. |
| 10-20 | Fair | A low confidence level. Positional measurements should be discarded or used only to indicate a very rough estimate of the current location. |
| > 20 | Poor | At this level, measurements are inaccurate by as much as 300 meters with a 6-meter-accurate device, so they should be discarded. |
OneAPI⚓︎
If you are using the OneAPI, all GNSS information is stored in the Vehicle State Capabilities.
| Vehicle State Capability | Description |
|---|---|
POSITION |
Position of the vehicle as latitude and longitude |
GNSS_HDOP |
Horizontal dilution of the GNSS precision |
GNSS_POSITION_FIX_QUALITY |
Fix quality of the GNSS position |
GNSS_SATELLITES_IN_USE |
Number of satellites used to compute the GNSS position |
GNSS_SPEED_OVER_GROUND_IN_KPH |
Computed speed of the vehicle in kilometers per hour using GNSS |