How to get Unit Last update date and time

Hello!

1) Last data information (unit name, speed, position, date/time) you can get via request search item (or search items ) with correspodings flags value.

2) Engine status , moving/parking status you can get via Events - trips and igntion 
To get live events the steps are the following

• Add units to session - https://sdk.wialon.com/wiki/en/sidebar/ … date_units

• Then execute request events/check_updates, for example every 2-5 sec, to get response with online data

For example

1. First (after login) it needs to add required units to session via request  svc=events/update_units

https://hst-api.wialon.com/wialon/ajax.html?svc=events/update_units&params={"mode":"add","units":[{"id":2147,"detect":{"ignition":0,"trips":0}},{"id":2174,"detect":{"ignition":0,"trips":0}}]}&sid=023078baa1999df1ea0da05cd4cbc9a02cb

"units" - units array where  'id' - unit's id, 'detect' - required events types, in our case only "ignition":0 and trips "trips":0, 0 means all ignition sensors, if you know that unit has only 1 ignition sensor, you can set up '0'.
If there is several ignition sensors it's better to set up sensor's id. But sure it depends on appropriate business task. For trips is always 0 ("trips":0).
It needs to specify for each units 'id' each 'detect' type.

2. After required units has been added to session, we can monitor online ingtion state via request events/check_updates which can be executed for example every 2 sec or rarely , it depends on how often the device sends data to the server

https://hst-api.wialon.com/wialon/ajax.html?svc=events/check_updates&params={"detalization":3}&sid=023078baa1999df1ea0da05cd4cbc9a02cb

"detalization":3  means that server will return  JSON information for flags plus

Hello!

You can get  "avg_speed" speed parameter, or "curr_speed": - current speed, parameter "m" shows the time of last message (Unix time UTC+0), the trip duration is calculated as difference between "from" and "to"

Hello!

To get history data of events (trips, ignition) you need to execute  events/load & events/get
First you load events for some period  - , then get  it
For example,

Get trips from Oct 1 - Oct 5 , unix time UTC+0

Load events

https://hst-api.wialon.com/wialon/ajax.html?svc=events/load&params={"ivalType":1,"itemId":214,"timeFrom":1601510400,"timeTo":1601942399,"detectors":[{"type":"trips","filter1":0}]}&sid=028384ac3f02f18c414208758685b320

Get result

https://hst-api.wialon.com/wialon/ajax.html?svc=events/get&params={"selector":{"type":"trips","timeFrom":1601510400,"timeTo":1601942399,"detalization":3}}&sid=028384ac3f028758685b320

Good day!

To display direction we use the parameter course which device can send.
If your device type sends this parameter, you can get it from messages.
For example, pos: {y: 53.9058786, x: 27.4569481, c: 38, z: 302.700012207, s: 0, sc: 11}, where parameter 'c' is course , integer (from 0 to 359 degrees, where 0 - means North)

Hello!

1) To get all reports created in account via request search items or
search item by ID  with flags = 8193 ( base flag + 8192 reports data)
2) To execute report - please look example  https://sdk.wialon.com/wiki/en/sidebar/ … es/reports
3) After report executed you can export it to file - please look the request format here https://sdk.wialon.com/wiki/en/sidebar/ … ort_result

Hello!

There is not quotes for text parameters, like "pageOrientation":portrait, "coding":utf8 and etc.

the correct params

{"format":2,"pageOrientation":"portrait","pageSize":"a4","pageWidth":0,"coding":"utf8","delimiter":"semicolon","headings":0,"compress":1,"attachMap":0,"extendBounds":0,"hideMapBasis":0,"outputFileName":"Online_report"}

Hello Gurtam team

I stuck with at below APi request that my client request to  notification send to login user users as their engine is on, engine off, speed limit and geozone

How i can set notification with specific units

like
1)Unit engine is on and get mobile notifications

2)Unit engine is Off and get mobile notifications

3) Unit is running more then set speed

next is get all notification of the units same as current attached screenshots

http://gps.tawasolmap.com/wialon/ajax.html?svc=resource/get_notification_data&params={"itemId":55874,"col":]}&sid=c59a1d9fe2a4927c94d540dd190b6956

Hello, Team Thanks for the Replay,

Before I call this API, Which API should i need to call to set that this login customer would get push notifications, like that

like Customer ABCD login with the application after authentication success, there are three Units associate with customer

1. BMW
2. Audi
3. Toyota

Now customers want to set a notification on each unit start. stop and speed that I will use your example API,

But my query is how that customer will get push notification in his Device- the phone  is there an API call for that to get notification

If you can please help in this also that how Notifications would work, like steps

Just use the request svc=item/delete_item where itemId is id of group.

Push notification is not able to set as of with app, but as example I have set for the email and its works for the above example

for this simple text, i got a success message, but as i have set some dynamic as per that last example you have updated for the geozone same i have use for the engine status On 

http://gps.tawasolmap.com/wialon/ajax.html?svc=resource/update_notification&params={"n":"example engine On","ta":1603746000,"td":0,"tz":134228528,"la":"en","ma":0,"sch":{"f1":0,"f2":0,"t1":0,"t2":0,"m":0,"y":0,"w":0,"fl":0},"ctrl_sch":{"f1":0,"f2":0,"t1":0,"t2":0,"m":0,"y":0,"w":0,"fl":0},"un":[20646,55304,54533],"trg":{"t":"sensor_value","p":{"sensor_type":"engine operation","sensor_name_mask":"*","lower_bound":1,"upper_bound":1,"prev_msg_diff":0,"merge":1,"type":0}},"d":"","act":[{"t": "email","p":{"email_to":"trushal.shah@brainvire.com","html":1,"img_attach":1,"subj":"TawasolMap Notification"}}],"txt": "Name of the Unit %UNIT% . At %POS_TIME% near '%LOCATION%' Engine Status is ON","fl":0,"mast":0,"mpst":0,"cdt":0,"mmtd":3600,"cp":3600,"id":6,"itemId":55874,"callMode":"update"}&sid=662b6d5cd6dccfecc01266b7604690df

getting error

{
    "error": 4,
    "reason": "WRONG_PARAMS"
}

i have set below text from your last example

"txt": "Name of the Unit %UNIT% . At %POS_TIME% near '%LOCATION%' Engine Status is ON"

Thanks for the update

Sure I will take care of this,

I just want to know  about engine status On/Off

Case1: Speed is greater then zero  then Engine is ON

Case 2" Speed is equal to zero then

Speed 0 then engine off but some time speed is zero but engine status looks ON in the wialon Application

so which field should i consider for the engine status

i have below details of ignition and trip

"20317": [
  {
    "ignition": {
      "1": {
        "from": {
          "t": 1601453651,
          "y": 26.5767269135,
          "x": 50.0240821838
        },
        "to": {
          "t": 1601454262,
          "y": 26.5540847778,
          "x": 50.021686554
        },
        "m": 1601454262,
        "f": 0,
        "state": 13.635,
        "type": 1,
        "hours": 821580,
        "switches": 505,
        "value": 13.635
      }
    }
  },
  {
    "trips": {
      "from": {
        "t": 1601453652,
        "y": 26.5767288208,
        "x": 50.0240821838
      },
      "to": {
        "t": 1601454262,
        "y": 26.5540847778,
        "x": 50.021686554
      },
      "m": 1601454262,
      "f": 0,
      "state": 1,
      "max_speed": 74,
      "curr_speed": 43,
      "avg_speed": 32,
      "distance": 5486,
      "odometer": 10899730,
      "course": 177,
      "altitude": 2
    }
  }

Hello chdi,

Thanks for your last update, Need your more help to execute the report with the group 

to exexute report with single unit as its working fine,

http://gps.tawasolmap.com/wialon/ajax.html?svc=report/exec_report&params={"reportResourceId":55874,"reportTemplateId":10,"reportObjectId":20646,"reportObjectSecId":0,"interval":{"from":1601449803,"to":1601877534,"flags":0}}&sid=38e426df6995780573aad7a2ce59732f

but how i can report for the group of units

i have group id 63926 and list of units in the group

[20306,54533,55304]

params={
  "reportResourceId": 55874,
  "reportTemplateId": 10,
  "reportObjectId": 63926,
  "reportObjectSecId": 0,
  "reportObjectIdList":[20306,54533,55304],
  "interval": {
    "from": 1601449803,
    "to": 1601877534,
    "flags": 0
  }
}&sid=38e426df6995780573aad7a2ce59732f

thanks for the response,

How i can get groups templates and unit template list which API should i call ?

http://gps.tawasolmap.com/wialon/ajax.html?svc=report/get_report_data&params={"itemId":55874,"col":[]}&sid=bc9c650e4b732d33ed2a04c91528df20

in response i am getting

[]

Thank you for your reply, that is my query how i can get that report templates ids like which template belong to units and which is for the unit groups

i need this for the report page

Thanks for replay

how i can use this "propValueMask":"1,*di*"

because with this i am not able to get data but if I set only with "propValueMask":"*" getting data

but getting  44 records but i can see there is just a few templates associate with an account with wialon mobile applications

please check the attached screenshot, i have taken from wialon application tab report click

Thanks for all your message,

as your last update that we can not send a push notification with wialon API,

then how i can send any link or any  support that I can set in my application to get notification same as wialon does

also that how I can get a list of notification that user get on a set of notification

i have attached three screenshots that I need to integrate this flow in my current application how i can do that which APi should is use

1) get List of notifications as per request
2) Any support URL that i can integrate to set push notifications the same as wialon app

thanks for your support again

As this works perfect for us, but here with a response

"type":"trips"

we are not getting idle or parking details of the unit, if you can please help me with which parameter we should update to get all unit trip details with movement and, parking

Thanks for your reply,

its works for us to get some movement of the unit with the center of the day but I am not getting if in the parking with start and endpoint

The first trip end time (to time) will be the starting of the parking time(from the time) and the second trip start time will be the end time of the parking event and so on we are calculating parking detail between all the trips.

1. How we can calculate the first parking event of the day which is shown in the attached image as point 1
2. How we can calculate the last parking event of the day which is shown in the attached image as point 2
- If it is the same day event then we are considering the current time as the end time of the last parking event, but for the last day we have considered the end time of the day 11:59 PM but we are not able to calculate that data

This is working for us properly , Here how we should manage engine status for below conditions how we should get flags in the response of this

Hello if you can please help me to get unit engine status with the bellow cases

How i can get it from API

1) Add key next to the icon when the engine starts it : Green with key when Vehicle is moving and the engine is on,

2) Red with key when the Vehicle stop and the engine is on,

3) Green only if the Vehicle moving without start engine so no key in this situation & red without key if the Vehicle stops and the engine off.

what we have considered that if speed is > 0 then engine status is ON and Speed = 0 then engine status is off but how we should calculate that speed with and engine status with current screens shots

Hi, thanks for your help and support

I want to bind the driver with a unit with a code or password

I can do create Driver with the below API it's working for me

resource/update_driver&params={"itemId":1299,"id":0,"callMode":"create","ej":"","c":"123456","ck":0,"ds":"Joy testing as driver","n":"Joy driver","p":" %2B1234567","r":0,"f":4,"pwd":"123456","jp":""}

                  
I can bind driver with unit
       

svc=resource/bind_unit_driver&params={"resourceId":1299,"unitId":1233,"driverId":1,"time":0,"mode":1}

How I can bind drive with a specific password of code which added on create a driver

for e.g i create one driver ABCD with code='123456' and password= 'ABCD'

and while the driver click to bind with the unit he/she needs to add their code

how to set bind driver with a passcode  if you can please help me

Also please help me how i can get all list of register drivres

so there is no such API where we can post driver id and password before bind driver with the unit?

Hello I need to know that as suggested API to get history of trips and its workig like charm, but here we get differet on display rooth path on the map,

svc=events/get

get a response from APi with start and end location

"trips": {
        "0": [
            {
                "from": {
                    "t": 1608526381,
                    "y": 24.7762775421,
                    "x": 46.6249923706
                },
                "to": {
                    "t": 1608527106,
                    "y": 24.7713947296,
                    "x": 46.6237869263
                }

and we use this start and end location as in the below API of the google

https://maps.googleapis.com/maps/api/directions/json?origin=\(source.latitude),\(source.longitude)&destination=\(destination.latitude),\(destination.longitude)&sensor=false&mode=driving&key=\(API_KEY)")

but we are getting the wrong path to compare to Wialon track location path at history page ,

if you can please help me that how i can get this root location from start to endpoint

Hello Thanks for the reply

https://sdk.wialon.com/wiki/en/kit/remoteapi/apiref/events/get#x1_flag

("detalization")  = 8

Which flag I should post that I can get all the details of the trip in a single response

distance key and engine hours with the same response where we get to track of the units

Hello thanks for your support

In the report, I request

Between date from 27/12/2020 00:00 AM
Between date To 27/12/2020 11:59 PM

exec_report API:

{"reportObjectSecId":0,"reportObjectId":20306,"interval":{"flags":0,"to":1609113599,"from":1609027200},"reportResourceId":"62290","reportTemplateId":1}"

exec_result API

"extendBounds":0,"pageWidth":0,"format":2,"headings":0,"coding":"utf8","pageSize":"a4","pageOrientation":"portrait","delimiter":"semicolon","attachMap":1,"outputFileName":"eabdalmnem_27/12/2020","hideMapBasis":1,"compress":0}

Above both API working and we are getting report as PDF file

But here the issue is we are not getting proper data with the above post formates

we use to get date as UTC time [timeFormatter.timeZone = TimeZone(abbreviation: "UTC")]

Please check two diff response screenshots

Initial location, Final location, Duration this data are coming proper

But Beginning time and End time coming wrong

thanks for the response,

Here if the customer location is in Saudi Arabia and maybe a different location then do we need to update each time different time zone

Hello

Thanks for your support,

if you can please support us for below query

Event Load:
{"ivalType":1,"itemId":54533,"timeFrom":1609007400,"timeTo":1609093799,"detectors":[{"type":"trips","filter1":0},{"type":"ignition","filter1":0}]}

Get Event

svc=events/get&params={"selector":{"type":"*","timeFrom":1609007400,"timeTo":1609093799,"detalization":11}}

Here how we can get stop details of the unit movement for track pages

please check the screenshot, we need to display the same stop icon on the map

Hi, thanks for the reply

we got the response trips{s<1} with this condition but same time we need trips data also

so how I can get all movement of the vehicle with stop, parking, and  trips in single response

Hi, thanks for the reply this works

but still, there is wrong location data on the map of the parking and stop comparing with webpenal

All data under s>1 consider as stop with less than 5 min different

As we compare with backend penal and mobile few locations consider as parking is considered as stop in the mobile.

1)i have attached a file of the response

2) screenshot of the web model with stop and parking

3) Mobile same request data with stop and parking

which condition would make can get same stop and parking location as web track on the map

Hello

thanks for the reply,

Sure i will do share more details with API call, response and mobile view with webview

In the share screenshots different is that

all location which we get as stop in the API are considered as Parking in the web,

so just want to know how we can get parking data stop data from the API

do we need to add any type like ignition?

Hello

I do send this message to get track data of the unit same as wialon page

same as the first image and the second image

but we are struggling to get data. we applied the same login you suggest getting between time data

its not sufficient to get the same data as the web does we if we apply s<1 then we are getting all the stops which are not there in the website

below is API call we done

APi URL:

Dates select 11/01/2021 to 12/01/2021 and unit id as 11489

http://gps.tawasolmap.com/wialon/ajax.html?svc=core/batch&sid=bdfabd36adfb22323b0a292ceb799ed5&params={"params":[{"svc":"events/load","params":{"ivalType":1,"itemId":11489,"timeFrom":1609439400,"timeTo":1609525799,"detectors":[{"type":"trips","filter1":0},{"type":"ignition","filter1":0}]}},{"svc":"events/get","params":{"selector":{"type":"trips","timeFrom":1609439400,"timeTo":1609525799,"detalization":11}}},{"svc":"events/get","params":{"selector":{"expr":"trips{s<1}","timeFrom":1609439400,"timeTo":1609525799,"detalization":11}}}],"flags":0}

let me know token required

and also I have attached result we from API call

check attached images that we need same stop and parking would display as wialon web/track page has

Please help me with this would much appreciate

Hello

if you can please help me that what would be the format of the URL to send push notification on engine On and Off

{
    "t":"push_messages",    /* action type */
    "p":{
        "url":<text>,        /* server name (port may be defined), start it with "http(s)" */
        "get":<bool>        /* request type: 1 - GET, 0 - POST */       
    }
}

this is what I have set but not getting a notification
https://localhost.ip/front/api/v1/send_push?user=username&msg='Hello'

Do we need to attache message to send push, ot Wialon server would send same which we had set on the text

Hello!

The URL for server is specified path with end point by which the GET/POST request from Wialon will be proceeded.
For example , at my server there is file php which proceeds GET request with some parameters , so at notification as URL I have specified the path to this file.
{t: "push_messages", p: {get: "1", url: "http://dinacheley.com/notif/index.php"}}
The parameters for GET/POST request are specified in notification text  as param1=some_value&param2=%some_wialon_tag%&.....
The parameters name/value  can be different.

Hi!

If you need to get  a full string as text messages,  you can specify at notification (notification's text)  parameter with JSON object
For example,  msg={"spec":"%UNIT% unit and so on %some_other_wialon_tags%"}
So server should get parameter 'msg' with JSON value, and parse this JSON

Hello!

Try to type  URL-encoding %20  instead space

Hello!

As I said before, it's better to send text as JSON parameter string type, i.e notification text is like paramName={"spec":"%UNIT% unit and so on %some_other_wialon_tags% some text with spaces"}
Sure the server should parse parameter paramName as JSON

In any case you should look through server parsing which get message from Wialon.
For example, our push server parse  any text from Wialon notifications, and users get the same text on mobile as in web interface.

Hello!

When you change notification , you need to send all parameters, not only changed.
Also the parameter "txt" value should be string, not object, so it needs ""

For example,

{"n":"dinacheley","ta":1614027600,"td":0,"tz":134228528,"la":"ru","ma":0,"sch":{"f1":0,"f2":0,"t1":0,"t2":0,"m":0,"y":0,"w":0,"fl":0},"ctrl_sch":{"f1":0,"f2":0,"t1":0,"t2":0,"m":0,"y":0,"w":0,"fl":0},"un":[20685653,21728414],"trg":{"t":"outage","p":{"type":"0","time":60,"check_restore":1}},"d":"","act":[{"t":"push_messages","p":{"url":"https://tawasoul.brainvire.dev/front/api/v1/send_push?user=brainvire&msg=","get":1}}],"txt":"{\"spec\":\"%UNIT%\"}","fl":0,"mast":0,"mpst":0,"cdt":0,"mmtd":3600,"cp":0,"id":124,"itemId":930849,"callMode":"update"}

Hello!

The requests events/load and events/get are used to get history events (trips, sensors, ignition , fuel thefts/fillings/consumption) which already registered in system
More - https://forum.gurtam.com/viewtopic.php? … 16#p186716

If you need to get current data, when unit is running online, you need to get use the following requests
https://sdk.wialon.com/wiki/en/sidebar/ … date_units - add units to session and specify event's detector
https://sdk.wialon.com/wiki/en/sidebar/ … ck_updates - execute request periodically to get data
See my previous answer - https://forum.gurtam.com/viewtopic.php? … 05#p183805

Hello!

When you execute command you need to pass the same parameters which original command has, like link type, commandName and etc.

In your example,
"n": "start engine" - commandName
"l": "" - link type (empty value means 'Auto')
"p": "Juste un exemple" - specified parameters

So you need to execute request unit/exec_cmd with the following parameters

"params":{"itemId":11489,"commandName":"start engine","linkType":"","param":"Juste un exemple","timeout":1,"flags":0}

Hi!

The device send this response to your command as I see on your screenshot, because there is not correct parameter 'Juste un exemple' for command. You need to send command (create command before for unit) with correct parameter for certain command. Please look to device's manual or request to manufacturer  which parameters are correct for this command type.
Maybe here on forum - https://forum.gurtam.com/viewforum.php?id=18  you can find helpful information

Hello

I need your 2 bits of help

1. Above request how to display Map background on the report

2. How to get sensor engine operation value in the check_updates API

From search_item API we got all sens value check_updates API

"sens": {
                "1": {
                    "id": 1,
                    "n": "حالة المحرك",
                    "t": "engine operation",
                    "d": "",
                    "m": "On/Off",
                    "p": "adc1",
                    "f": 0,
                    "c": "{\"act\":0,\"appear_in_popup\":true,\"ci\":{},\"mu\":0,\"pos\":1,\"show_time\":false,\"timeout\":0,\"uct\":0,\"unbound_code\":\"\",\"validate_driver_unbound\":0,\"consumption\":2}",
                    "vt": 1,
                    "vs": 0,
                    "tbl": []
                },
                "2": {
                    "id": 2,
                    "n": "الكهرب",
                    "t": "voltage",
                    "d": "",
                    "m": "V",
                    "p": "pwr_int",
                    "f": 0,
                    "c": "{\"act\":1,\"appear_in_popup\":true,\"ci\":{},\"cm\":0,\"mu\":\"0\",\"pos\":2,\"show_time\":false,\"timeout\":0,\"uct\":0}",
                    "vt": 1,
                    "vs": 0,
                    "tbl": []
                }

I am looking for same value from update_unit API how i can get, i do get but I got a second sensor not first

svc=events/update_units&params={"mode":"add","units":[{"id":11489,"detect":{"sensors":0}}]}&sid=c0816af7dfa8862ae026cf4a1499f2d8

svc=events/check_updates&params={"detalization":3}&sid=9e0f2c649220ff65229c68a56de69f3e

"11489": [
        {
            "sensors": {
                "2": {
                    "from": {
                        "t": 1615747447,
                        "y": 24.7718658447,
                        "x": 46.633014679
                    },
                    "to": {
                        "t": 1620026997,
                        "y": 24.7718448639,
                        "x": 46.6330413818
                    },
                    "m": 1620026997,
                    "f": 0,
                    "type": 4,
                    "value": 4.141
                }
            }
        }
    ]
}

Hello Thanks for the reply it's working fine

to add the unit to get the update we set this API as per your suggestion and its working fine when we have small[20] set of units

but when I have 500 units then we get error

1.{"id":11489,"detect":{"ignition":0,"sensors":0}}
2.{"id":11499,"detect":{"ignition":0,"sensors":0}}
.
.
.
500 .{"id":11989,"detect":{"ignition":0,"sensors":0}}

<head>
    <title>414 Request-URI Too Large</title>
</head>

events/update_units&params={"mode":"add","units":[{"id":11489,"detect":{"ignition":0,"sensors":0}}]}&sid=75252dc521f0c23fd8be8085452bd6ff

Hello,

How I can get the last movement of the vehicle, i am not getting the last movement if any vehicle is running so i can display on the map.

for i.e my last trip was 2 PM after in parking, next i started at 6 PM and my car running so i could not get 6 PM running data till its moves as parking

can you please help me on this....

core/batch&params={"params":[{"svc":"events\/load","params":{"ivalType":1,"itemId":55873,"timeFrom":1623954600,"timeTo":1624040999,"detectors":[{"type":"trips","filter1":0}]}},{"svc":"events\/get","params":{"selector":{"type":"*","timeFrom":1623954600,"timeTo":1624040999,"detalization":11}}},{"svc":"events\/get","params":{"selector":{"type":"*","expr":"trips{s<1}","timeFrom":1623954600,"timeTo":1624040999,"detalization":11}}}],"flags":0}&sid=47a5b1d3697adb0fe149fb7a3c086559

Thanks for update

The query is above API will get the vehicle's last location.

e.t my last trip ends at 2 PM and I have started at 3 Pm new trip and continue

I can get till 2 PM all location of the vehicle but Runnin trips[All movement need to display at Map] i am not sure how i can get 
with

can we made any cane in load / get trip data API

like till last message movement data on map

Please find attach the request

Thanks for the update

yes, this I do use to display running car on the map and its movement

but here I need to display his all past and current running movement on the Map

e.g I started my vehicle at 6 AM and I moves to continue for 5 hours, till 11 AM

and in between if I want to see his trip all position on the Map from 6 to 8 and still vehicle is moving,