Ροή διαδρομών

GET/v1/analytics/trips

Επιστρέφει μία γραμμή για κάθε διαδρομή που ξεκίνησε μέσα στο διάστημα ημερομηνιών. Οι γραμμές ταξινομούνται κατά ώρα έναρξης και μετά κατά αριθμό διαδρομής.

Χρησιμοποιήστε αυτή τη ροή για να δείτε πού και πότε κινήθηκε κάθε όχημα και ποιος οδηγός το οδηγούσε.

Παράμετρος	Υποχρεωτική	Σημειώσεις
since	Ναι	Πρώτη ημερομηνία του στόλου, σε μορφή YYYY-MM-DD.
until	Ναι	Τελευταία ημερομηνία του στόλου, σε μορφή YYYY-MM-DD. Και τα δύο όρια περιλαμβάνονται. Το διάστημα δεν μπορεί να ξεπερνά τις 366 ημέρες.
limit	Όχι	Γραμμές ανά σελίδα, από 1 έως 5000. Προεπιλογή 1000.
offset	Όχι	Η πρώτη γραμμή που επιστρέφεται. Προεπιλογή 0. Χρησιμοποιήστε το next_offset της απάντησης για την επόμενη σελίδα.

Στείλτε ένα κλειδί API με το δικαίωμα analytics:read στην κεφαλίδα Authorization. Ένα κλειδί διαβάζει μόνο δεδομένα του οργανισμού του. Οι κανόνες που ισχύουν για όλες τις ροές είναι στη σελίδα Αναλύσεις BI.

Παράδειγμα

Αίτημα:

curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/analytics/trips?since=2026-10-01&until=2026-10-31&limit=5000' \
  -H "Authorization: Bearer filodos_REPLACE_WITH_YOUR_KEY"

Απάντηση (200). Το παράδειγμα δείχνει δύο από τις 418 γραμμές. Μια πραγματική σελίδα έχει έως limit γραμμές. Το next_offset είναι null στην τελευταία σελίδα.

{
  "rows": [
    {
      "trip_id": 8812,
      "device_id": 43,
      "vehicle_name": "IKX-1234",
      "driver_names": "Nikos Papadopoulos",
      "started_at": "2026-10-01T07:42:10+03:00",
      "ended_at": "2026-10-01T08:31:55+03:00",
      "duration_minutes": 49.75,
      "distance_km": 38.6,
      "max_speed_kmh": 104.0,
      "idle_minutes": 6.5,
      "night_km": 0.0,
      "overspeed_km": 1.2,
      "harsh_brake_count": 1,
      "harsh_accel_count": 0,
      "event_count": 2,
      "start_latitude": 37.9838,
      "start_longitude": 23.7275,
      "end_latitude": 38.0457,
      "end_longitude": 23.8016
    },
    {
      "trip_id": 8820,
      "device_id": 44,
      "vehicle_name": "IKY-5678",
      "driver_names": null,
      "started_at": "2026-10-31T23:05:00+02:00",
      "ended_at": null,
      "duration_minutes": null,
      "distance_km": 3.1,
      "max_speed_kmh": null,
      "idle_minutes": null,
      "night_km": null,
      "overspeed_km": null,
      "harsh_brake_count": null,
      "harsh_accel_count": null,
      "event_count": 0,
      "start_latitude": 37.9421,
      "start_longitude": 23.6463,
      "end_latitude": null,
      "end_longitude": null
    }
  ],
  "total": 418,
  "limit": 5000,
  "offset": 0,
  "next_offset": null
}

Στο Excel

1. Δημιουργήστε το ερώτημα με τα βήματα της ενότητας Excel Power Query.
2. Ορίστε Feed = "trips" στο ερώτημα.
3. Επιλέξτε Κλείσιμο & φόρτωση (Close & Load).

Το φύλλο έχει τότε μία γραμμή για κάθε γραμμή της απάντησης. Μια τιμή null δίνει κενό κελί. Μερικές στήλες του παραδείγματος φαίνονται έτσι:

Πεδία

Κάθε γραμμή έχει αυτά τα πεδία, με αυτή τη σειρά. Μια χρονοσφραγίδα είναι σε μορφή ISO 8601, σε ώρα Ευρώπης/Αθήνας, με ρητή μετατόπιση ώρας.

Πεδίο	Τύπος	Σημασία
trip_id	ακέραιος	Ο αριθμός διαδρομής στο Filodos. Η ροή συμβάντων χρησιμοποιεί τον ίδιο αριθμό.
device_id	ακέραιος	Ο αριθμός συσκευής στο Filodos.
vehicle_name	κείμενο ή null	Το όνομα του οχήματος, συνήθως η πινακίδα.
driver_names	κείμενο ή null	Οι οδηγοί που ήταν συνδεδεμένοι με το όχημα στην έναρξη της διαδρομής.
started_at	χρονοσφραγίδα	Η έναρξη της διαδρομής, σε ώρα Ευρώπης/Αθήνας με μετατόπιση.
ended_at	χρονοσφραγίδα ή null	Το τέλος της διαδρομής. null όσο η διαδρομή είναι ανοιχτή.
duration_minutes	αριθμός ή null	Ο χρόνος από την έναρξη ως το τέλος. null όσο η διαδρομή είναι ανοιχτή.
distance_km	αριθμός ή null	Η απόσταση της διαδρομής σε χιλιόμετρα.
max_speed_kmh	αριθμός ή null	Η μέγιστη ταχύτητα της διαδρομής.
idle_minutes	αριθμός ή null	Ο χρόνος με αναμμένη μηχανή και ταχύτητα κάτω από 3 km/h.
night_km	αριθμός ή null	Η απόσταση από 22:00 έως 06:00 τοπική ώρα.
overspeed_km	αριθμός ή null	Η απόσταση πάνω από αναρτημένο όριο ταχύτητας.
harsh_brake_count	ακέραιος ή null	Απότομα φρεναρίσματα που βρίσκει το Filodos από τα δεδομένα ταχύτητας.
harsh_accel_count	ακέραιος ή null	Απότομες επιταχύνσεις που βρίσκει το Filodos από τα δεδομένα ταχύτητας.
event_count	ακέραιος	Συναγερμοί και συμβάντα οδήγησης (σοβαρότητα 2 ή 3) στη διαδρομή. Οι γραμμές τους είναι στη ροή συμβάντων.
start_latitude	αριθμός ή null	Το γεωγραφικό πλάτος του σημείου έναρξης.
start_longitude	αριθμός ή null	Το γεωγραφικό μήκος του σημείου έναρξης.
end_latitude	αριθμός ή null	Το γεωγραφικό πλάτος του σημείου τέλους.
end_longitude	αριθμός ή null	Το γεωγραφικό μήκος του σημείου τέλους.

Τα πεδία από max_speed_kmh έως harsh_accel_count προέρχονται από την ανάλυση της διαδρομής. Είναι null μέχρι να εκτελεστεί η ανάλυση εκείνης της ημέρας.

Μια διαδρομή ανήκει στην ημέρα που ξεκίνησε. Μια διαδρομή που περνά τα μεσάνυχτα εμφανίζεται μία φορά.

Σφάλματα

Μια απάντηση σφάλματος έχει σώμα JSON με πεδίο detail.

Κωδικός	Αιτία
401	Λείπει η κεφαλίδα Authorization, ή το κλειδί είναι άγνωστο ή ανακλημένο.
403	Το κλειδί δεν έχει το δικαίωμα analytics:read, ή η είσοδος είναι είσοδος οδηγού.
422	Το until είναι πριν από το since, το διάστημα ξεπερνά τις 366 ημέρες, μια ημερομηνία δεν είναι σε μορφή YYYY-MM-DD, ή το limit ή το offset είναι εκτός ορίων.