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.

https://www.drivool.com/track/vtschool.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://moverstrack.firebaseapp.com/vtschool.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://moverstrack.firebaseapp.com/vtschool.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://moverstrack.firebaseapp.com/vtschool.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://moverstrack.firebaseapp.com/vtschool.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":"stmaryroute002","mobile":"","name":"","route":"Route
2","type":3},{"busno":"","desc":"","gpstype":6,"id":"stmaryroute001","mobile":"","name":"","route":"Route 1","type":3},
{"busno":"","desc":"","gpstype":0,"id":"stmaryroute003","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.

Post body
[{"busno":"","desc":"","gpstype":0,"id":"stmaryroute002","mobile":"","name":"","route":"Route 2","type":3},
{"busno":"","desc":"","gpstype":6,"id":"stmaryroute001","mobile":"","name":"","route":"Route 1","type":3},
{"busno":"","desc":"","gpstype":0,"id":"stmaryroute003","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.

Post body
[
   ["Shubham Yadav", "SR000996", "photo_url", "mobile", "tpt_r1@stangelscoin", "Route1", "II", "B", "S001", "S001"],
   ["Maanvi Kashyap", "SR000876", "photo_url", "mobile", "tpt_r1@stangelscoin", "Route1", "III", "A", "S002", "S002"],
   ["Om Kashyap", "SR000579", "photo_url", "mobile", "tpt_r1@stangelscoin", "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.

Response
[
   ["Shubham Yadav", "SR000996", "photo_url", "mobile", "tpt_r1@stangelscoin", "Route1", "II", "B", "S001", "S001"],
   ["Maanvi Kashyap", "SR000876", "photo_url", "mobile", "tpt_r1@stangelscoin", "Route1", "III", "A", "S002", "S002"],
   ["Om Kashyap", "SR000579", "photo_url", "mobile", "tpt_r1@stangelscoin", "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

Response

    {
        "9873456781":{ // Parents Mobile number
            "BNPS20140020":{ // Child’s student id
                   "c":"", // Class
                   "i":"routed5_sn@bnpsramvihareduin", // Route Id
                   "n":"Khwahish verma", // Student Name
                   "p":"http://schoolportal.com/10011400018.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@bnpsramvihareduin",
                    "n":"Mayank arora",
                    "p":"http://schoolportal.com/10011300082.jpg" ,
                    "r":"Sr: 7",
                    "s":{"d":"10011700120","p":"10011700120"}
            }
        }
    }

For any query reach at info@drivool.com