Data Forwarding

Data Forwarding

Data Forwarding allows you to forward device(s) data to an external server.

Data will be saved on our platform, and also forwarded to your specified endpoint.

Forwarded data will be sent in CSV over UDP.

The receiving server will need a listening application that can accept the data transmission (using UDP) on port 21928 

We have the capability to add different formats if the existing ones do not suit your requirements.

The "COMMON" format is the most popular, here is a CSV example of the COMMON format: 

  • Gpsdate, //datetime tracker got the fix
  • Imei, //unique identifier
  • Latitude, //co-ordinates
  • Longitude, //co-ordinates
  • Odometer, //in KM
  • EventID, //our unique identifier for the event type, i.e. ignition on, ignition off, position report, overspeed etc
  • IgnitionOn, //true or false
  • battery, //internal tracker battery power
  • VehicleSpeed, //in kph
  • RoadSpeedLimit, //in kph
  • Heading, // 0-360 degree integer value (aka compass direction with north being 0)
  • Attributes,   //Number Of Sats, etc
  • CellTowerInfo,//MMC, MNC, LAC, ID
  • AssetName, //usually vehicle registration plate or how you have named asset in asset menu
  • ClientId, //WLT internal ID associated with the client
  • DriverID, //WLT internal ID of the driver
  • SensorData, //analog, 1-wire, serial (fuel/temperature etc)
  • CanBusData //fuel, throttle position, engine temp etc (if available)

 

JSON example format we currently send to our clients via HTTP:

{
      "SerialNo": "00000000-0000-0000-0000-000000000000",
      "Imei": 350544500812584,
      "Latitude": "-1.269623",
      "Longitude": "36.778338",
      "GPSDate": "24/01/2024 07:28:50",
      "Heading": 191,
      "EventID": 124,
      "EventName": "Position",
      "AdditionalEventInfo": "",
      "Odometer": 1481.045,
      "EngineHours": 3245673,
      "VehicleSpeed": 16.000005824,
      "RoadSpeedLimit": "0",
      "RoadName": "Sri Aurobindo Avenue, Lavington, Nairobi",
      "DriverID": 0,
      "IsIgnitionOn": true,
      "Altitude": "1740",
      "CanBusData": "{\"RPM\":\"0\",\"OdometerTrip\":\"0\",\"ntcT1\":\"31.00\",\"ntcT2\":\"29.30\",\"ntcT3\":\"31.10\",\"cb16\":\"0\",\"cb33\":\"0\",\"batS\":\"20\",\"ntcP\":\"3\",\"ps\":\"0\",\"fc\":\"43820\",\"dc\":\"30\",\"rc\":\"21830\",\"rc_p\":\"50\",\"curr\":\"0\",\"tv\":\"74710\",\"c1v\":\"3735\",\"c2v\":\"3737\",\"c3v\":\"3737\",\"c4v\":\"3737\",\"c5v\":\"3736\",\"c6v\":\"3731\",\"c7v\":\"3733\",\"c8v\":\"3734\",\"c9v\":\"3734\",\"c10v\":\"3735\",\"c11v\":\"3736\",\"c12v\":\"3737\",\"c13v\":\"3734\",\"c14v\":\"3736\",\"c15v\":\"3736\",\"c16v\":\"3736\",\"c17v\":\"3737\",\"c18v\":\"3738\",\"c19v\":\"3738\",\"c20v\":\"3738\",\"c21v\":\"59558\",\"c22v\":\"0\",\"c23v\":\"0\",\"c24v\":\"0\",\"c25v\":\"0\",\"c26v\":\"0\",\"c27v\":\"0\",\"c28v\":\"0\",\"c29v\":\"0\",\"c30v\":\"0\",\"ev\":\"73863\",\"me\":\"0\",\"he\":\"0\",\"te\":\"0\",\"ce\":\"0\",\"be\":\"0\",\"lhb\":\"0\",\"lmm\":\"0\",\"bm\":\"1\",\"cm\":\"0\",\"sbm\":\"0\",\"prnd\":\"1\",\"gr\":\"0\",\"rpm_l\":\"0\",\"rpm_h\":\"0\",\"bv_l\":\"231\",\"bv_h\":\"2\",\"bc_l\":\"254\",\"bc_h\":\"255\",\"ct\":\"48\",\"mt\":\"51\",\"ha\":\"0\",\"hb\":\"1\",\"hc\":\"0\",\"ts\":\"0\",\"oc\":\"0\",\"ov\":\"0\",\"uv\":\"0\",\"cot\":\"0\",\"mot\":\"0\",\"mcs\":\"1\",\"mds\":\"1\",\"pd\":\"2023-10-10\",\"sw\":\"0x0042\",\"hem\":\"SJV1.1BAK45A2310-0284  \"}",
      "Attributes": "{\"Sat\":\"16\",\"HDop\":\"0.6\",\"PDop\":\"0.9\",\"VDop\":\"0\",\"RSSI\":\"100\",\"iccid\":\"892540140000105486303\",\"ev\":73863}",
      "Format": 0,
      "Protocol": "teltonika",
      "VendorId": "350544500812584",
      "battery": "96",
      "format_id": 0,
      "SendProtocol": 0
    }

NOTE: The content-type header that we send is "application/json; charset=utf-8". It is important that implementers ensure they can ignore the charset portion.


Setup Data Forwarding Providers

1. Login to Site 

2. Go to Admin

3. Go to Data Forwarding 

4. Click on New Data Forwarding Provider

5. Populate the details

6. Save.

Setup Data Forwarding Devices

1. Login to Site 

2. Go to Admin (top menu)

3. Go to Data Forwarding (left menu)

4. Click on Data Forwarding Devices

5. Select the Provider from the list

6. Select Client 

7. Select the assets that need data forwarding enabled

8. Save

Example String of the data forwarded:

 16/09/2020 05:46:03,352093084007995,-1.3350133,36.7069199,32.811,124,True,100,0.0,6,-1,{"Sat":"10","Power":"12.95","RSSI":"80"},,,,0,,#



AZURE IOT FORWARDING

If you intend to forward data to Azure, please ensure you use the forwarding end point such as:
HostName=yourazurecompanyaccountname.azure-devices.net;DeviceId=whitelabeltrackingdevices;SharedAccessKey=xxxxxxxxxxxxxx

    • Related Articles

    • Understanding Telemetry

      Whether you are new to telematics or mastering advanced integration, this glossary is a handy reference for everything you need to know about telematics. For better databases and app performances we have resolved to slim some telemetry data to save ...

    • Server Ip and ports

      Where do I point my trackers? First read the overview of pointing devices to the platform You will need 2 settings to point a tracker to our servers Port - look up the port for my device Server address - data.gpsiot.net Port Each manufacturer has a ...

    • Whitelisting domains for IOT Sim providers

      WHITELISTING If your device uses IOT sim cards, some providers insist on white listing IP addresses, please make sure the IOT SIM PROVIDER whitelists the following IP's (you should still use data.gpsiot.net for your trackers) 45.77.140.96 ...

    • How do I adjust the odometer/mileage of an asset

      This article gives an overview of how to update the odometer or mileage value on the app or how to synch the odometer value with the one in the vehicle. Click on asset info under asset info select manage mini-tab on the odometer section in the manage ...

    • Teltonika FMB/FMC & Other Series

      This article explains the 3 ways to activate your Teltonika device. 1. Using the Add Asset Wizard within the web-app This is the easiest but least reliable way to configure your devices (due to factors outside of our control). Click here for more ...