Staționări

Descriere Generală

Metoda Stops returnează o listă cu staționările vehiculelor în perioada pentru care se face apelul. Aceasta returnează doar datele pentru vehiculele la care utilizatorul are acces. În cazul în care lista conține cel puțin un vehicul la care utilizatorul nu are acces, se va returna un răspuns cu cod de eroare 401.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/stops?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Parametri Request

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:49:19.549",
  "endDate": "2024-09-09T09:49:19.549",
  "stationaryMargin": 0
}

vehiclesList: Lista de ID-uri ale vehiculelor pentru care se solicită staționările (maxim 10 vehicule).
startDate: Data și ora de început a perioadei pentru care se solicită staționările.
endDate: Data și ora de sfârșit a perioadei pentru care se solicită staționările.
stationaryMargin: Timpul de staționare exprimat în minute (nu poate fi mai mic de 1 minut).

Structura Răspunsului

{
  "payload": [
    {
      "results": {
        "additionalProp1": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ],
        "additionalProp2": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ],
        "additionalProp3": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ]
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Descrierea Proprietăților

payload: Lista staționărilor vehiculelor.
- results: Rezultatele staționărilor pentru fiecare vehicul.
  - vehicleId: ID-ul vehiculului.
  - startDate: Data și ora de început a staționării.
  - endDate: Data și ora de sfârșit a staționării.
  - latitude: Latitudinea locației staționării.
  - longitude: Longitudinea locației staționării.
  - stationaryEngineOnTime: Timpul de staționare cu motorul pornit.
  - distance: Distanța parcursă.
  - maxSpeed: Viteza maximă atinsă.
  - averageSpeed: Viteza medie.
  - speedCount: Numărul de măsurători de viteză.
  - indexKm: Indexul de kilometri.
  - indexHours: Indexul de ore.
  - address: Adresa locației staționării.
  - stopDuration: Durata staționării.
  - engineOnStops: Lista evenimentelor cu motorul pornit.
    - startDate: Data și ora de început a staționării cu motorul pornit.
    - endDate: Data și ora de sfârșit a staționării cu motorul pornit.
    - duration: Durata staționării cu motorul pornit.
  - hotSpot: Numele hotspotului daca stationarea s-a produs în unul din hotspoturile definite.
  - functioningTime: Timpul de funcționare.
  - isPrivate: Indicator dacă staționarea este privată.
  - drivers: Lista șoferilor.
    - firstName: Prenumele șoferului.
    - lastName: Numele de familie al șoferului.
  - fuelConsumption: Consumul de combustibil pe deplasarea anterioară şi staţionarea curentă (dacă s-a staţionat cu motorul pornit).
correlationId: ID-ul unic pentru corelarea cererii și răspunsului.
failureReasons: Lista motivelor de eșec, dacă există.
- errorCode: Codul de eroare.
- errorParameters: Parametrii suplimentari pentru eroare.
isSuccess: Indicator dacă cererea a fost procesată cu succes.