When does BikeTrax record the Positions / Trips?
Which parameters determines a complete ride in the powunity app?
The tracker always records, even if it is only moved 10m. If you use the /positions API then you always get all the positions that the tracker has sent for the period.
But there is a difference in when the server (or the app) detect and show it as a trip (via the /trips API). The following parameters are used in the detection algorithm:
minimal trip duration - Trips of less than 130 seconds are ignored.
minimal trip distance - Trips of less than 215 meters are ignored.
minimal parking duration - Parking for less than five minutes does not detected as stop.
minimal no data duration - Gaps in reported positions longer than one hour are considered as stops.
ignition - Force switch to stop state if eBike is switched off.
Following is an example to illustrate how it works:
Trip 1 is detected correctly, because the period started from zero speed (initialized as stopped), the distance is longer than 215 meters or the duration is longer than 130 seconds, and it is followed by a stop longer than minimal parking duration.
Stop 1 is detected because it has a duration longer than the minimal parking duration and the speed is close to zero.
Trip 2 is also detected correctly from row 27 on, rows 24-25 are ignored as fluctuation. Parameters are more than minimal, and it started and followed by positions with zero speed.
Why and how straight lines occur and what does it imply on the status of the tracker?
If the bike is located in a garage (without GPS reception) and is immediately driven away from there, the GPS needs longer until it gets a position and the start / first position is then correspondingly later. This is because the GPS fix can take up to one minute, especially if the tracker is moving.
What is the meaning of the tracker status/values and columns of the route report?
When selecting a tracker, the “State” panel on the left shows you the relevant variables and their values as seen on the last reported position of the device. Those are also the meaningful columns to display in the “Route” reports.
Generally the GPS server supports many different tracker manufacturers with varying use cases, but for us the interesting columns are:
Device Name
Time
Latitude
Longitude
Speed - in knots/hour
Alarm - with possible values:
vibration - when tracker is moved / shaken
movement - when
powerCut (bike switched off),, speed,…
lowBattery - when backup battery state is getting low
Hours - duration the tracker was moving / operated
Input - will include the data as received from CAN bus
Battery Level - SOC of the backup battery
Ignition and Charge - if tracker has external power supply (e.g. bike switched on / off)
Distance - since start of the current trip
Total Distance - since tracker was created / added to platform
Motion - tracker moving yes / no
Armed - if the trackers vibration alarm is switched on (this should mostly be true)
How to switch the speed unit from nautical speed (kn) to km/h or mph?
You can switch the default setting using the following steps:
How are Alarms / Push Notifications delivered?
There are two ways how the push notification (which triggers the sound) is handled by the app depending on it’s state:
The app is in the background (or not running):
none of our app code is run -> the push is handled only by the OS / browser. In that case the alarm will only sound for a few seconds and then stop - unless the backend / server sends another push because the device is still moving and movement alarm was triggered again.The app is in the foreground:
Notification is handled by our app code and we start playing the alarm sound in a loop until the user switches if off (by toggling the alarm button).