Traseu

Descriere Generală

Metoda Way returnează lista cu locațiile vehiculelor din perioada transmisă ca parametru. Aceasta returnează doar vehiculele la care utilizatorul are acces. Metoda acceptă ca parametri o listă de maxim 10 vehicleId și o perioadă de maxim 31 de zile.

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/way?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:21:50.133",
  "endDate": "2024-09-09T09:21:50.133"
}

• vehiclesList: Lista de vehicleId-uri pentru care se dorește obținerea locațiilor.
• startDate: Data și ora de început a perioadei pentru care se solicită locațiile.
• endDate: Data și ora de sfârșit a perioadei pentru care se solicită locațiile.

Structura Răspunsului

{
  "payload": [
    {
      "vehicleId": 0,
      "gpsDate": "2024-09-09T09:21:50.134~~~~",
      "latitude": 0,
      "longitude": 0,
      "speed": 0,
      "course": 0
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Descrierea Proprietăților

• payload: Lista locațiilor vehiculelor.
  • vehicleId: ID-ul unic al vehiculului.
  • gpsDate: Data și ora ultimei actualizări GPS.
  • latitude: Latitudinea locației vehiculului.
  • longitude: Longitudinea locației vehiculului.
  • speed: Viteza vehiculului.
  • course: Direcția de deplasare a vehiculului.
• 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.