{
  "opencollection": "1.0.0",
  "info": {
    "name": "Automile ClientApi ResourceOwnerTrip3V2 API",
    "version": "v1"
  },
  "items": [
    {
      "info": {
        "name": "ResourceOwnerTrip3V2",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get all trips that the user has access to",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3",
            "params": [
              {
                "name": "lastNumberOfDays",
                "value": "",
                "type": "query",
                "description": "Optional enter last number of days to get trips for"
              },
              {
                "name": "vehicleId",
                "value": "",
                "type": "query",
                "description": "Optional vehicle id to get trips for"
              },
              {
                "name": "synchronized",
                "value": "",
                "type": "query",
                "description": "Optional include synchronized trips (defaults to true)"
              },
              {
                "name": "fromUtc",
                "value": "",
                "type": "query",
                "description": "Retrieve trips from this date. (Can't be used if lastNumberOfDays is specified)"
              },
              {
                "name": "toUtc",
                "value": "",
                "type": "query",
                "description": "Retrieve trips to this date. (Can't be used if lastNumberOfDays is specified)"
              }
            ]
          },
          "docs": "Only returns trips that the user have access to"
        },
        {
          "info": {
            "name": "Get the details about the trip",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "Only trips that are associated with the vehicles that user has relationships with are allowed."
        },
        {
          "info": {
            "name": "Updates the given trip with a trip type (category) and trip tags",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id to update"
              }
            ]
          },
          "docs": "This operation would only update the trip type and trip tags if authorized for this trip."
        },
        {
          "info": {
            "name": "Get the trip start and stop geo locations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/geostartend",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "Only trips that are associated with the vehicles that user has relationships with are allowed."
        },
        {
          "info": {
            "name": "Get the vehicle speed if it's reported by the vehicle",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/speed",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "This is a quick method, instead of retrieving raw data with the pid operation. Is reported in km/h."
        },
        {
          "info": {
            "name": "Get the vehicle engine rpm if it's reported by the vehicle",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/rpm",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "This is a quick method, instead of retrieving raw data with the pid operation."
        },
        {
          "info": {
            "name": "Get the vehicle ambient (outside) temperature if it's reported by the vehiclee",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/ambienttemperature",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "This is a quick method, instead of retrieving raw data with the pid operation. The result is in celsius."
        },
        {
          "info": {
            "name": "Get the vehicle current fuel level if it's reported by the vehicle",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/fuellevelinput",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "This is a quick method, instead of retrieving raw data with the pid operation. The result is in percentage of total 100"
        },
        {
          "info": {
            "name": "Get the engine coolant temperature if it's reported by the vehicle",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/enginecoolanttemperature",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "This is a quick method, instead of retrieving raw data with the pid operation"
        },
        {
          "info": {
            "name": "This will get the raw PID data if the vehicle has reported that it is being recorded",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/pid/:pidId",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              },
              {
                "name": "pidId",
                "value": "",
                "type": "path",
                "description": "The PID id"
              }
            ]
          },
          "docs": "The data array will contain a sub-array of integers representing the raw data"
        },
        {
          "info": {
            "name": "Get the gps locations for the vehicle, includes position and heading",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/geo",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              },
              {
                "name": "everyNthRecord",
                "value": "",
                "type": "query",
                "description": "Optional if you wish to limit to n:th number of records"
              },
              {
                "name": "snapToRoad",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "This operation would require compression enabled by the client."
        },
        {
          "info": {
            "name": "Gets Google static map URL with the trip route as a polyline",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/googleurltostaticmapencodedpolyline",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              },
              {
                "name": "height",
                "value": "",
                "type": "query",
                "description": "Height of the map"
              },
              {
                "name": "width",
                "value": "",
                "type": "query",
                "description": "Width of the map"
              }
            ]
          },
          "docs": "Gets Google static map URL with the trip route as a polyline"
        },
        {
          "info": {
            "name": "Updates the given trip with given contactid",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/setdriverontrip",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "query",
                "description": "The trip to update"
              },
              {
                "name": "contactId",
                "value": "",
                "type": "query",
                "description": "The contact id for the driver"
              }
            ]
          },
          "docs": "This operation would only update the driver if authorized for this trip."
        },
        {
          "info": {
            "name": "Get the details about the trip including driving events, speeding and idling",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/details",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "Only trips that are associated with the vehicles that user has relationships with are allowed."
        },
        {
          "info": {
            "name": "Get the advanced details about the trip including driving events, speeding, idling, speed and rpm data series",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/:tripId/advanced",
            "params": [
              {
                "name": "tripId",
                "value": "",
                "type": "path",
                "description": "The trip id"
              }
            ]
          },
          "docs": "Only trips that are associated with the vehicles that user has relationships with are allowed."
        },
        {
          "info": {
            "name": "Updates a list of trip id's with the provided trip type",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "{{baseUrl}}/v1/resourceowner/trips3/batch/triptype"
          },
          "docs": "This operation only updates the trip types if authorized to all trips in list."
        }
      ]
    }
  ],
  "bundled": true
}