KEYSTONE API Standard
  1. Vehicle
KEYSTONE API Standard
  • KEYSTONE API Standard
  • Data Schema
    • Diagram
    • Transport Operation
    • Vehicle
    • Driver
  • Paths & Endpoints
    • Transport Operation
      • Create new transport operation data
      • Get all transport operation data
      • Get a specific transport operation data by ID
      • Update data for a specific transport operation by ID
      • Delete specific transport operation data by ID
      • Get schedule data related to a specific transport operation by ID
      • Update schedule data for a specific transport operation by ID
      • Get all phase data related to a specific transport operation by ID
      • Append phase data for a specific transport operation by ID
      • Get specific phase data by transport operation ID and phase ID
      • Update specific phase data by transport operation ID and phase ID
      • Get all international consignment notes related to a specific transport operation by ID
      • Append international consignment notes data for a specific transport operation by ID
      • Get specific international consignment notes data by transport operation ID and reference code
      • Update specific international consignment notes data by transport operation ID and reference code
      • Delete specific international consignment notes data by transport operation ID and reference code
      • Get specific transport operation data by country code and license plate number
      • Get details about the schedule of specific transport operation by country code and license plate number
      • Get details about all the phases of specific transport operation by country code and license plate number
      • Get specific phase data by country code, license plate number, and phase ID
      • Get all international consignment notes related to a specific transport operation by country code and license plate number
      • Get specific international consignment notes data by country code, license plate number, and reference code
    • Vehicle
      • Create new vehicle data
        POST
      • Get all vehicle data
        GET
      • Get vehicle data by country code and license plate number
        GET
      • Update vehicle data by country code and license plate number
        PUT
      • Delete specific vehicle data by country code and license plate number
        DELETE
      • Get details about the geolocation of vehicle by country code and license plate number
        GET
      • Append new vehicle's geolocation data by country code and license plate number
        PATCH
      • Get details about the owner of vehicle by country code and license plate number
        GET
      • Get details about the insurances of vehicle by country code and license plate number
        GET
      • Get details about the insurance of vehicle by country code, license plate number and insurance id
        GET
      • Get details about the revisions of vehicle by country code and license plate number
        GET
      • Get details about the revision of vehicle by country code, license plate number and revision id
        GET
    • Driver
      • Create new driver data
      • Get all driver data
      • Get driver data by country code and vat number
      • Update driver data by country code and vat number
      • Delete specific driver data
      • Get details about the driver's license by country code and vat number
      • Get details about the driver's traffic violations by country code and vat number
      • Get specific driver's traffic violation data by country code, vat number and traffic violation id
      • Get details about the driver's tachograph cards data by country code and vat number
      • Get specific driver's tachograph card data by country code, vat number and tachograph card id
  1. Vehicle

Append new vehicle's geolocation data by country code and license plate number

PATCH
/vehicles/{countryCode}/{plateNumber}/geolocations/
Vehicle

Request

Path Params
countryCode
string 
required
Country code of the vehicle's registration.
plateNumber
string 
required
License plate number of the vehicle.
Body Params application/json
Details of the vehicle's geolocation.
dateTime
string <date-time>
required
Date and time the vehicle was located at the given coordinates.
Example:
2023-06-25T10:00:00Z
Match pattern:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
coordinates
object (Coordinates) 
required
Details about the coordinates.
latitude
number <double>
required
Latitude in Decimal Degrees (DD).
>= -90<= 90
Example:
34.052235
longitude
number <double>
required
Longitude in Decimal Degrees (DD).
>= -180<= 180
Example:
-118.243683
Example
{
  "dateTime": "2023-06-25T10:00:10Z",
  "coordinates": {
    "latitude": 44.43420688779947,
    "longitude": 8.958240077553329
  }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.company-server/v1/vehicles///geolocations/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dateTime": "2023-06-25T10:00:10Z",
    "coordinates": {
        "latitude": 44.43420688779947,
        "longitude": 8.958240077553329
    }
}'

Responses

🟢200OK
application/json
Geolocation data appended successfully
Body
array of:
dateTime
string <date-time>
required
Date and time the vehicle was located at the given coordinates.
Example:
2023-06-25T10:00:00Z
Match pattern:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
coordinates
object (Coordinates) 
required
Details about the coordinates.
latitude
number <double>
required
Latitude in Decimal Degrees (DD).
>= -90<= 90
Example:
34.052235
longitude
number <double>
required
Longitude in Decimal Degrees (DD).
>= -180<= 180
Example:
-118.243683
Example
{
  "dateTime": "2023-06-25T10:00:10Z",
  "coordinates": {
    "latitude": 44.43420688779947,
    "longitude": 8.958240077553329
  }
}
🟠400Bad Request
🟠404Record Not Found
🔴500Server Error
Previous
Get details about the geolocation of vehicle by country code and license plate number
Next
Get details about the owner of vehicle by country code and license plate number
Built with