Sending location data to Node-RED

After getting location data, app will send data to Node-RED though a http_node. By default, you should name URL in this node to "/location", and app will send data to "admin_url/location".

However, you can also set up your own location URL in Location setting
App use 'username' and 'password' of Dashboard for authentication this URL (httpNodeAuth)
App post data
- lat: Latitude
- lon: Longitude
- name: Name of device, unique for track line and map display
- icon: Icon on map display. Using font awesome (eg: fa-user-circle) or and url of image (http://mydomain/image.png)
- iconColor: color of icon, could be text (eg: green, red) or #rrggbb (eg: #FF0000)

Setting of App

Track on app start: Very IMPORTANT, if false, location tracking will not run when app start and you need to do it manually
Location URL: Explain aboved
Security: For authentication, app use 'username' and 'password' of Dashboard for authentication this URL (httpNodeAuth)
Location Provider: Read here if you are interested and want to change
Desire Accuracy: The more accuracy, battery consumed.
Stationary Radius: Stationary radius in meters. When stopped, the minimum distance the device must move beyond the stationary location for aggressive background-tracking to engage.
Distance Filter: The minimum distance (measured in meters) a device must move horizontally before an update event is generated
Stop on terminate: Enable this in order to force a stop when the application terminated (e.g. on iOS, double-tap home button, swipe away the app).
startOnBoot (Android only): Start background service on device boot.
Icon and Icon color: Explained above

Flows for Node-RED

To display data on map, it is recommended to install node-red-contrib-web-worldmap . This flow get data, create a map and drawing track. A disadvantage is: This node does not have time updated data. Below is flows to receive data and display on map. You need to edit worldmap node to choose the right layout for Dashboard UI

Show/Hide Flow

App Permission

In iOS, when mimimize app with location tracking on, you will be asked for permission, choose always.

If you miss this panel, access Seting -> RED Client Editor -> and set location setting to always

Testing and debugging

This feature allow you to test data sent from phone, display on map. You can also change lat and lon to manipulate moving for testing location tracking and draw tracking line on map.