Overview

School bus tracking application("SBTA") is our most complex built. uMove Admin is a common admin application across all our business app including SBTA. If you are at this page, learning about drivool APIs for a different use case, a subset of API will work for your business case. We are continuosly improving our platform and workflow.Please reach us at info@drivool.com if you don't find somthing you are searching for.

Tracking Url for webview

Purpose

For various reasons, you may wish to take a combination of vehicles displayed along with their associated objects in a webview. You may be doing this either to embed in your webpage or mobile app or share with customer.

Embed with iframe

This availble for both realtime tracking as well as tracking history.

https://drivool.com/track/embed.html? g=<GAPN> &k=<API_KEY> &showonly=<COMMA_SEPARATED_ROUTE_IDS_WITH_OPTIONAL_STOP_IDS>

Note:

API_KEY can be copied from uMove Admin -> ERP interface

If “showonly” parameter is missing then map will display all vehicles.

Example 1: Display Three vehicles along with stop ids 


       https://drivool.com/track/embed.html?
        g=GAPN & 
        k= API_KEY &
        showonly=route001,route002,route003

Example 2: Display vehicle route001 along with stops and stop with id p1 will be marked as red in pickup route and stop with id d1 will be marked as red in drop route 


       https://drivool.com/track/embed.html?
        g=GAPN &
        k=API_KEY &
        showonly=route001.p1.d1

Example 3: Display vehicle route001 along with stops and stop with id p1 will be marked as red in pickup route 


       https://drivool.com/track/embed.html?
        g=GAPN & 
        k= API_KEY &
        showonly=route001.p1

Example 4: Display vehicle route001 along with stops and stop with id d1 will be marked as red in drop route 


       https://drivool.com/track/embed.html?
        g=GAPN & 
        k= API_KEY &
        showonly=rroute001..d1

Drivool uMove Admin

ERP interface

ERP interface feature is availble only in our business application customers. uMove Admin app is unversal for all our customer including retail app. In case you don't find ERP interface link, please reach us at info@drivool.com.

screenshot

1. if your wish to trigger your alert server, provide your url above at (1). Whenever vehicle approaches to any bus stop, your url will be called along with alert data as below. 


{
 "gapn" : “gapn”,
 "id" : “route id”,
 “type”: 0, // 0 - pickup, 1- drop
 "stop" : “stop id”,
 "name" : “stop name”,
 "aid" : “alert id”
 "route" : “route name”,
 "fil" : “f” , // First , Intermediate, Last
 "time" : 3:54 PM, //ETA
 "epoc" : 1529576539877 //epoc time in milliseconds
 }

2. As indicated in screenshot above, you can obtain your API key from (2). API key will be required to contruct your url. This is unique key for given GAPN.

API : getTrace

Provides historical traces of vehicle movements.

Response : Array of locations representing path of vehicle movements.

https://us-central1-drivoolapis.cloudfunctions.net/getTrace?key=KKKKKKKKKKKK&gapn=GGGGGG&route=RRRRRR&date=mmddyyyy

Where

   > KKKKKKKKKKKK is API key
   > GGGGGG is GAPN
   > RRRRRR is Route id
   > mmddyyyy is date in month day year
Post body
         Nothing is passed as post body

API : getRoute

Provides route of given route id and type.

https://us-central1-drivoolapis.cloudfunctions.net/getRoute?key=KKKKKKKKKKKK&gapn=GGGGGG&route=RRRRRR&type=p

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN
> RRRRRR is Route id
> type is route type ( p: pickup, d: drop )

Example response:

[{"ald":1000,"id":"p0","lat":18.9801,"lng":72.83063,"tag":"Planet
Godrej","type":1},{"lat":18.98006,"lng":72.83061},{"lat":18.98006,"lng":72.83061},{"lat":18.97991,"lng":72.83116},{"lat":18.97975,"lng":72.
8317},{"lat":18.97974,"lng":72.83176},{"lat":18.97973,"lng":72.83184},{"lat":18.97973,"lng":72.8319},{"lat":18.97973,"lng":72.83198},{"lat
":18.97973,"lng":72.83198},{"lat":18.98067,"lng":72.83193},{"lat":18.98194,"lng":72.83189},{"lat":18.98621,"lng":72.83175},{"lat":18.9864
9,"lng":72.83174},{"lat":18.9866,"lng":72.83174},{"ald":1000,"id":"p3","lat":18.98671,"lng":72.83173,"tag":"LODHA
Primero","type":3},{"lat":18.98741,"lng":72.83169},{"lat":18.98844,"lng":72.83164}]

Where

ald : alert node distance from actual stop in meters
id : Stop Id
lat : latitude
lng : longitude
tag : Stop name
type : Stop type ( 1. First Stop, 2. Way point but not stop, 3/4, Intermediate pickup/drop
Stop, 5. Last Stop
Post body
         Nothing is passed as Post body

API : putRoute

Updates route of vehicles to Drivool server.

https://us-central1-drivoolapis.cloudfunctions.net/putRoute?key=KKKKKKKKKKKK&gapn=GGGGGG&route=RRRRRR&type=p

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN
> RRRRRR is Route id
> type is route type ( p: pickup, d: drop )
Post body
[{"ald":1000,"id":"p0","lat":18.9801,"lng":72.83063,"tag":"Planet
Godrej","type":1},{"lat":18.98006,"lng":72.83061},{"lat":18.98006,"lng":72.83061},{"lat":18.97991,"lng":72.83116},{"lat":18.97975,"lng":72.
8317},{"lat":18.97974,"lng":72.83176},{"lat":18.97973,"lng":72.83184},{"lat":18.97973,"lng":72.8319},{"lat":18.97973,"lng":72.83198},{"lat
":18.97973,"lng":72.83198},{"lat":18.98067,"lng":72.83193},{"lat":18.98194,"lng":72.83189},{"lat":18.98621,"lng":72.83175},{"lat":18.9864
9,"lng":72.83174},{"lat":18.9866,"lng":72.83174},{"ald":1000,"id":"p3","lat":18.98671,"lng":72.83173,"tag":"LODHA
Primero","type":3},{"lat":18.98741,"lng":72.83169},{"lat":18.98844,"lng":72.83164}]

Where

ald : alert node distance from actual stop in meters
id : Stop Id
lat : latitude
lng : longitude
tag : Stop name
type : Stop type ( 1. First Stop, 2. Way point but not stop, 3/4, Intermediate pickup/drop
Stop, 5. Last Stop

API : getVehicles

Provides list of vehicles with last updated timestamp.

https://us-central1-drivoolapis.cloudfunctions.net/getVehicles?key=KKKKKKKKKKKK&gapn=GGGGGG

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN

Example response:

{"buses":[{"busno":"","desc":"","gpstype":0,"id":"route002","mobile":"","name":"","route":"Route
2","type":3},{"busno":"","desc":"","gpstype":6,"id":"route001","mobile":"","name":"","route":"Route 1","type":3},
{"busno":"","desc":"","gpstype":0,"id":"route003","mobile":"","name":"","route":"Route 3","type":3}],
"timestamp":1528088838696}

Where

busno : Vehicle License plate no
gpstype : GPS device type
id : Route Id
mobile : Attendant mobile no
name : Attendant name
route : Route Name
type : Vehicle type
Post body
         Nothing is passed as Post body

API : putVehicles

Updates list of vehicles to Drivool server.

https://us-central1-drivoolapis.cloudfunctions.net/putVehicles?key=KKKKKKKKKKKK&gapn=GGGGGG

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN
Post body
[{"busno":"","desc":"","gpstype":0,"id":"route002","mobile":"","name":"","route":"Route 2","type":3},
{"busno":"","desc":"","gpstype":6,"id":"route001","mobile":"","name":"","route":"Route 1","type":3},
{"busno":"","desc":"","gpstype":0,"id":"route003","mobile":"","name":"","route":"Route 3","type":3}]

Where

busno : Vehicle License plate no
gpstype : GPS device type
id : Route Id
mobile : Attendant mobile no
name : Attendant name
route : Route Name
type : Vehicle type

API : putStudents

Updates list of students to Drivool server.

https://us-central1-drivoolapis.cloudfunctions.net/putVehicles?key=KKKKKKKKKKKK&gapn=GGGGGG

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN
Post body
[
   ["Shubham Yadav", "SR000996", "photo_url", "mobile", "tpt_r1", "Route1", "II", "B", "S001", "S001"],
   ["Maanvi Kashyap", "SR000876", "photo_url", "mobile", "tpt_r1", "Route1", "III", "A", "S002", "S002"],
   ["Om Kashyap", "SR000579", "photo_url", "mobile", "tpt_r1", "Route1", "VI", "A", "S002", "S002"]
]

Where array items are organized as below:

0 - Student Name
1 - Student Id
2 - Student photo url
3 - Parents mobile
4 - vehicle id assigned
5 - Route Name
6 - Class, 7 - Section
8- Pickup stop id,
9- Drop stop id

API : getStudents

Retrieves list of students from Drivool server.

https://us-central1-drivoolapis.cloudfunctions.net/putVehicles?key=KKKKKKKKKKKK&gapn=GGGGGG

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN
Response
[
   ["Shubham Yadav", "SR000996", "photo_url", "mobile", "tpt_r1", "Route1", "II", "B", "S001", "S001"],
   ["Maanvi Kashyap", "SR000876", "photo_url", "mobile", "tpt_r1", "Route1", "III", "A", "S002", "S002"],
   ["Om Kashyap", "SR000579", "photo_url", "mobile", "tpt_r1", "Route1", "VI", "A", "S002", "S002"]
]

Where array items are organized as below:

0 - Student Name
1 - Student Id
2 - Student photo url
3 - Parents mobile
4 - vehicle id assigned
5 - Route Name
6 - Class, 7 - Section
8- Pickup stop id,
9- Drop stop id

API : getParents

Retrieves parents wise students data from drivool server

https://us-central1-drivoolapis.cloudfunctions.net/putParents?key=KKKKKKKKKKKK&gapn=GGGGGG

Where

> KKKKKKKKKKKK is API key
> GGGGGG is GAPN
Response

    {
        "9873456781":{ // Parents Mobile number
            "BNPS20140020":{ // Child’s student id
                   "c":"", // Class
                   "i":"routed5_sn", // Route Id
                   "n":"Khwahish verma", // Student Name
                   "p":"http://yourschoolportal.com/student_ID_01.jpg" , //Student’s photo url
                   "r":"R-23 SN", // Route Name
                   "S":{"d":"10011700305","p":"10011700305"} // Pickup and Drop Stop ids
            }
        },
        "9873456782":{
            "BNPS20130118":{
                    "c":"",
                    "i":"route7_sn",
                    "n":"Mayank arora",
                    "p":"http://yourschoolportal.com/student_ID_02.jpg" ,
                    "r":"Sr: 7",
                    "s":{"d":"10011700120","p":"10011700120"}
            }
        }
    }

Raw Data

Drivool 890 IN is designed and manufactured in Bangalore. Our GPS features include but are not limited to realtime tracking, geofence, sleep/work mode, shake-sensor, and engine status. This GPS also reports battery voltage and GSM network strength, making it an ideal product for Electic vehicles.

You can build your application quickly with our prebuilt UI as mentioned above. However, if your require to get the realtime raw data instead, there are two ways to achive it.

1) Get data directly to your server from Device : This capability is avaible only in our developer version. Contact us at info@drivool.com to purchase that model of device.
2) Get raw data from standard "Drivool 890 IN" device: Historical raw data is accessible thorugh standrad API. However, the avaiablity of realtime raw data is possbile only by running a dedicated instance of our server to push data to your server. We entertain this request when your requirment size is over 500 units.

For any query reach at info@drivool.com