Blame
| fca509 | Hargata Softworks | 2024-01-28 17:09:22 | 1 | # Odometer |
| 2 | ||||
| 3 | The Odometer tab is where you can log your current odometer reading without having to insert any Service/Repair/Upgrade/Fuel records. This odometer readings entered in this tab allows Reminder urgencies to be calculated as accurately as possible since it uses the maximum mileage reported in each of the tabs to determine the last reported mileage. | |||
| 4 | ||||
| 5 | The Odometer tab is hidden by default and must be enabled by checking the "Odometer" switch under "Visible Tabs" in the Settings tab. | |||
| 5cd648 | Hargata Softworks | 2024-01-28 17:13:11 | 6 | |
| e9def0 | Hargata Softworks | 2024-03-15 03:57:04 | 7 | ## Negative Distance Values |
| 8 | ||||
| 9 | This tends to happen when odometer records are inserted out of chronological order, to fix this, all you have to do is select all of the records, right click on them, and select "Recalculate Distance" This will update all of the initial mileages to be in a chronological order. | |||
| 10 | ||||
| 5cd648 | Hargata Softworks | 2024-01-28 17:13:11 | 11 | ## API Integration |
| 12 | As with the other tabs, odometer readings can be retrieved via a GET endpoint and inserted via a POST API endpoint. | |||
| 13 | ||||
| 14 | Example use cases: | |||
| 15 | - An app to integrate with OBDII and insert odometer reading from the vehicle's computer onto LubeLogger. | |||
| 16 | - An app to keep track of distance traveled via GPS and incrementing the last reported odometer reading. | |||
| 17 | ||||
| 18 | These are not functionalities provided out of the box by LubeLogger, and are just examples of the possibilities achievable via the API endpoints. | |||
| dc1ccd | Hargata Softworks | 2024-10-21 15:18:29 | 19 | |
| 20 | ::: warning | |||
| 21 | # Experimental Feature | |||
| 22 | Feature describe below is in an experimental phase and may not be stable or available in current release. | |||
| 23 | ::: | |||
| 24 | ||||
| 25 | ## Trip Recorder | |||
| 26 | New in 1.3.9, an experimental feature to tap into the users devices' GPS to update odometer and record routes while driving. | |||
| 27 | ||||
| 91f4e0 | Hargata Softworks | 2024-10-22 21:23:13 | 28 | This feature requires the LubeLogger instance to be served via **HTTPS** to a device with a browser that supports **Geolocation** and **Wakelock API**. When a trip is being recorded, the app will prevent the screen/device from going to sleep, and will retrieve the user's coordinates every 5 seconds. |
| 29 | ||||
| 30 | This feature is not available for vehicles using engine hours instead of miles or kilometers for distance unit. | |||
| dc1ccd | Hargata Softworks | 2024-10-21 15:18:29 | 31 | |
| 32 | You will need to enable Precise Location for your browser in order for LubeLogger to retrieve your location accurately. | |||
| 33 | ||||
| 34 | In iOS: | |||
| d5523e | Hargata Softworks | 2024-10-21 15:36:56 | 35 | |
| dc1ccd | Hargata Softworks | 2024-10-21 15:18:29 | 36 | Settings > Privacy & Security > Location Services > Safari Websites > Precise Location |
| 37 | ||||
| d5523e | Hargata Softworks | 2024-10-21 15:36:56 | 38 | In Android(Depends on Device Manufacturer): |
| 39 | ||||
| 40 | Settings > Location > App Location Permissions > Chrome > Precise Location | |||
| 41 | ||||
| 42 | ### Recording a Trip | |||
| 43 | Onec you have all the configurations above enabled, when you click on "Add Odometer Record", you will now see a red record button right next to the "Increment Odometer" button | |||
| 44 | ||||
| 45 |  | |||
| 46 | ||||
| 47 | Click on the record button and you will be taken to record trip modal: | |||
| 48 | ||||
| 49 |  | |||
| 50 | ||||
| 51 | Read the Disclaimer. Click "Start Recording" and drive around, you should see the odometer increment when you've driven about a mile or so(subject to device accuracy). | |||
| 52 | ||||
| 53 | Clicking on the current odometer reading shows the sub-odometer reading. Note that the sub-odometer reading is never saved as LubeLogger does not support decimals for odometer reading. This display is purely for checking if the tracking functionality is working. | |||
| 54 | ||||
| 55 |  | |||
| 56 | ||||
| 31fe15 | Hargata Softworks | 2024-10-21 15:40:59 | 57 | Do not close this window or exit out of the app when recording is in progress, PWAs are only allowed to query location information if it is in the foreground. |
| 58 | ||||
| e77a16 | Hargata Softworks | 2024-10-21 15:40:29 | 59 |  |
| 60 | ||||
| d5523e | Hargata Softworks | 2024-10-21 15:36:56 | 61 | Once you are done recording your trip, click the "Stop Recording" button. If the final odometer reading is different from the initial odometer reading, then a "Save" button will be displayed: |
| 62 | ||||
| 63 |  | |||
| 64 | ||||
| 65 | Click "Save" and you will be brought back to the "Add Odometer Record" screen, the odometer reading field will be updated, and there will also be a file that is pending upload named "coordinates.csv". If you add this odometer record, the file will be uploaded. | |||
| 66 | ||||
| 67 |  | |||
| 68 | ||||
| 69 | The coordinates.csv file contains a list of coordinates saved from the trip in 0.1 mile or km increments. To visualize the file, simply upload it to a coordinate plotter such as GPS Visualizer and it will plot the coordinates out on a map. |