Motia WS/API - Journey Report

Craig Marsden
Craig Marsden
  • Updated

 

The Journey Report web service allows you to integrate your own software/services with the Motia Telematics devices. 

 

Service URL

https://ws.mycubo.online/IntegrationService.svc

 

Service Method and Input Parameters

GetGPSJList(string token, string FromDate, string ToDate, string VehicleReg)

- FromDate –date time (DD/MM/YYYY & HH:MM Format eg 01/01/2022%2000:00)
- ToDate – date time (DD/MM/YYYY & HH:MM Format eg 01/01/2022%2023:59)

- VehicelReg - Registration number from assets (xyz,abc) (Multiple Reg should be in comma separated)

- Token -By Using below api to get the token (Instructions Here)

(https://ws.mycubo.online/IntegrationService.svc/AuthorizeUser?username=INTG-username&password=INTG-password)

 

Service Response

- ErrorMessage - empty for successful call

- GPSJ – list of data

 

Sample Response – Expired or Invalid Token

Request

https://ws.mycubo.online/IntegrationService.svc/GetGPSJList? token=$2a$10$PETZSdgJmRv243soXNqfeeU1I6t/RNu1XoPTmay/JpzMb2E635hhS &FromDate=01/05/2022%2000:00&ToDate=01/05/2022%2023:59&VehicleReg=09D131489,FJ67ZFC

Response

{

    "GPSJ": null,

    "ErrorMessage": "Token was expired."

}

 

Sample Response – Invalid Credentials

Request

https://ws.mycubo.online/IntegrationService.svc/GetGPSJList? token=$2a$10$PETZSdgJmRv243soXNqfeeU1I6t/RNu1XoPTmay/JpzMb2E635hhS &FromDate=01/05/2022%2000:00&ToDate=01/05/2022%2023:59&VehicleReg=09D441489,FJ61ZFC

Response

{

"GPSJ": null,

"ErrorMessage": "Login failed. Please enter valid username and password."

}

 

Sample request – Too Many Requests Per Minute

Request

https://ws.mycubo.online/IntegrationService.svc/GetGPSJList token=$2a$10$PETZSdgJmRv243soXNqfeeU1I6t/RNu1XoPTmay/JpzMb2E635hhS &FromDate=01/05/2022%2000:00&ToDate=01/05/2022%2023:59&VehicleReg=09D441489,FJ61ZFC

Response

{

"GPSJ": null,

"ErrorMessage": "Last request was 3 seconds ago. Request is allowed once per

60 second period."

}

 

Sample Request – Correct Request

Request

https://ws.mycubo.online/IntegrationService.svc/GetGPSJList? token=$2a$10$PETZSdgJmRv243soXNqfeeU1I6t/RNu1XoPTmay/JpzMb2E635hhS &FromDate=01/05/2022%2000:00&ToDate=01/05/2022%2023:59&VehicleReg=09D441489,FJ61ZFC

Response

{

    "ErrorMessage": null,

    "GPSJ": [

        {

            "JourneysList": [

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 14.62,

                    "Driver": null,

                    "DurationSeconds": "01:01:49",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:35:38",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": true,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 57,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D441489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "07:09",

                    "StartLatitude": 54.6718125,

                    "StartLocation": "Mallusk Road, Newtownabbey,  BT36 4 , UK",

                    "StartLongitude": -5.9904555,

                    "StopDateShort": "08:11",

                    "StopLatitude": 54.5256871,

                    "StopLocation": "M1, Lisburn,  BT27 5 , UK",

                    "StopLongitude": -6.0030023

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 108.82,

                    "Driver": null,

                    "DurationSeconds": "02:03:44",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:03:16",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": true,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 59,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "08:19",

                    "StartLatitude": 54.5256545,

                    "StartLocation": "M1, Lisburn,  BT27 5 , UK",

                    "StartLongitude": -6.0030141,

                    "StopDateShort": "10:23",

                    "StopLatitude": 53.2959203,

                    "StopLocation": "Grants Drive, Dublin,         , IE",

                    "StopLongitude": -6.4735881

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 0.00,

                    "Driver": null,

                    "DurationSeconds": "00:07:48",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:07:49",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 1,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "10:59",

                    "StartLatitude": 53.2958808,

                    "StartLocation": "Grants Drive, Dublin,         , IE",

                    "StartLongitude": -6.4735375,

                    "StopDateShort": "11:07",

                    "StopLatitude": 53.2959173,

                    "StopLocation": "Grants Drive, Dublin,         , IE",

                    "StopLongitude": -6.473934

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 0.40,

                    "Driver": null,

                    "DurationSeconds": "00:03:31",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:01:53",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 16,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "11:52",

                    "StartLatitude": 53.2959133,

                    "StartLocation": "Grants Drive, Dublin,         , IE",

                    "StartLongitude": -6.4738441,

                    "StopDateShort": "11:56",

                    "StopLatitude": 53.2959851,

                    "StopLocation": "Greenogue Business Plaza, Dublin,         , IE",

                    "StopLongitude": -6.4697261

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 57.07,

                    "Driver": null,

                    "DurationSeconds": "01:18:10",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:14:16",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": true,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 59,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "12:02",

                    "StartLatitude": 53.296503,

                    "StartLocation": "College Road, Dublin,         , IE",

                    "StartLongitude": -6.4696868,

                    "StopDateShort": "13:20",

                    "StopLatitude": 53.9315023,

                    "StopLocation": "M1, Commons (Dromiskin),         , IE",

                    "StopLongitude": -6.4167371

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 65.81,

                    "Driver": null,

                    "DurationSeconds": "01:23:56",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:07:59",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": true,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 59,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "13:23",

                    "StartLatitude": 53.9316768,

                    "StartLocation": "M1, Commons (Dromiskin),         , IE",

                    "StartLongitude": -6.416757,

                    "StopDateShort": "14:47",

                    "StopLatitude": 54.6715053,

                    "StopLocation": "Mallusk Road, Newtownabbey,  BT36 4 , UK",

                    "StopLongitude": -5.9904458

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 0.00,

                    "Driver": null,

                    "DurationSeconds": "00:01:19",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:01:19",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 2,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "15:39",

                    "StartLatitude": 54.6715373,

                    "StartLocation": "Mallusk Road, Newtownabbey,  BT36 4 , UK",

                    "StartLongitude": -5.990349,

                    "StopDateShort": "15:40",

                    "StopLatitude": 54.6717141,

                    "StopLocation": "Mallusk Road, Newtownabbey,  BT36 4 , UK",

                    "StopLongitude": -5.9905053

                },

                {

                    "CalampDriverId": "Gary Squires",

                    "CalculatedMPG": 0,

                    "Distance": 0.01,

                    "Driver": null,

                    "DurationSeconds": "00:02:54",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:02:50",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 6,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "09D131489",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "15:42",

                    "StartLatitude": 54.6717235,

                    "StartLocation": "Mallusk Road, Newtownabbey,  BT36 4 , UK",

                    "StartLongitude": -5.9906275,

                    "StopDateShort": "15:45",

                    "StopLatitude": 54.671513,

                    "StopLocation": "Mallusk Road, Newtownabbey,  BT36 4 , UK",

                    "StopLongitude": -5.99069

                }

            ],

            "Registration": "09D131489"

        },

        {

            "JourneysList": [

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 0.01,

                    "Driver": null,

                    "DurationSeconds": "00:00:28",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:00:24",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 6,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "152KY1247",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "14:32",

                    "StartLatitude": 52.2388521,

                    "StartLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StartLongitude": -9.7931863,

                    "StopDateShort": "14:32",

                    "StopLatitude": 52.2389325,

                    "StopLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StopLongitude": -9.7933668

                },

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 6.52,

                    "Driver": null,

                    "DurationSeconds": "00:23:27",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:09:23",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": true,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 59,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "152KY1247",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "14:38",

                    "StartLatitude": 52.2389378,

                    "StartLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StartLongitude": -9.7934436,

                    "StopDateShort": "15:01",

                    "StopLatitude": 52.2630366,

                    "StopLocation": "Kings Court, Tralee,         , IE",

                    "StopLongitude": -9.675848

                },

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 6.41,

                    "Driver": null,

                    "DurationSeconds": "00:14:26",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:01:26",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": true,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 52,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "152KY1247",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "16:06",

                    "StartLatitude": 52.2630858,

                    "StartLocation": "Kings Court, Tralee,         , IE",

                    "StartLongitude": -9.6758576,

                    "StopDateShort": "16:20",

                    "StopLatitude": 52.2389315,

                    "StopLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StopLongitude": -9.7933648

                },

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 0.09,

                    "Driver": null,

                    "DurationSeconds": "00:01:57",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:01:36",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 6,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "152KY1247",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "16:24",

                    "StartLatitude": 52.2388788,

                    "StartLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StartLongitude": -9.7934836,

                    "StopDateShort": "16:26",

                    "StopLatitude": 52.2378551,

                    "StopLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StopLongitude": -9.7921686

                },

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 0.03,

                    "Driver": null,

                    "DurationSeconds": "00:00:29",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:00:14",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 6,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "152KY1247",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "16:29",

                    "StartLatitude": 52.2377566,

                    "StartLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StartLongitude": -9.7921056,

                    "StopDateShort": "16:29",

                    "StopLatitude": 52.2382506,

                    "StopLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StopLongitude": -9.7924453

                },

                {

                    "CalampDriverId": "",

                    "CalculatedMPG": 0,

                    "Distance": 0.02,

                    "Driver": null,

                    "DurationSeconds": "00:00:29",

                    "EventId": "SQ HB",

                    "FuelUsed": 0,

                    "HACount": 0,

                    "HBCount": 0,

                    "HCCount": 0,

                    "HLCount": 0,

                    "HRCount": 0,

                    "IMEI": 0,

                    "IdleTimeSeconds": "00:00:25",

                    "IsCurrentJourney": false,

                    "IsNotAuthorised": false,

                    "IsOverspeed": false,

                    "IsStartLocationPOI": false,

                    "IsStopLocationPOI": false,

                    "JourneyCost": 0,

                    "JourneyMaxSpeed": 0,

                    "MapPlotJourneyData": null,

                    "MapPlotURL": null,

                    "Message": null,

                    "Registration": "152KY1247",

                    "Show": true,

                    "Speed": 0,

                    "SpeedLimit": 0,

                    "StartDateShort": "16:52",

                    "StartLatitude": 52.2382665,

                    "StartLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StartLongitude": -9.7924856,

                    "StopDateShort": "16:53",

                    "StopLatitude": 52.2385246,

                    "StopLocation": "Curraheen, Curraheen (Tralee),         , IE",

                    "StopLongitude": -9.7926938

                }

            ],

            "Registration": "152KY1247"

        },

        {

            "JourneysList": [],

            "Registration": "201D6300"

        }

    ]

}

Comments

0 comments

Article is closed for comments.