mobile

Patras Traffic web service (json) τεκμηρίωση

Η υπηρεσία επιστρέφει σε json μορφή πληροφορίες για τον εκτιμώμενο χρόνο διαδρομών. Οι πληροφορίες αυτές αφορούν στα κάτωθι:

  1. Κωδικός διαδρομής: μία αυτοματοποιημένη κωδικοποίηση για κάθε ξεχωριστή διαδρομή που ορίζεται από δύο σημεία ανιχνευτών
  2. Εκτιμώμενος χρόνος σε δευτερόλεπτα
  3. Κατάσταση διαδρομής
  4. Ημερομηνία και ώρα τελευταίας ενημέρωσης
  5. Τίτλος διαδρομής στα Ελληνικά

Κάθε απόκριση περιέχει –ανάλογα με τις παραμέτρους κλήσης- ένα σύνολο από πληροφορίες διαδρομών. Έτσι, για παράδειγμα, μία κλήση για ενημέρωση για όλες τις διαδρομές μπορεί να φέρει ένα αποτέλεσμα σαν το κάτωθι:

{"id":-1,"result":[{"id":150,"travelTimeSeconds":254,"condition":"Good","lastUpdate":"2014-10-07T15:27:23.8130000+00:00","title":"\u03a0\u03b1\u03bd\u03b1\u03b3\u03b9\u03ce\u03c4\u03b7 \u039a\u03b1\u03bd\u03b5\u03bb\u03bb\u03bf\u03c0\u03bf\u03cd\u03bb\u03bf\u03c5 - \u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u039d\u03af\u03ba\u03b7\u03c2"},{"id":152,"travelTimeSeconds":224,"condition":"Good","lastUpdate":"2014-10-07T15:27:23.8130000+00:00","title":"\u03a0\u03b1\u03bd\u03b1\u03b3\u03b9\u03ce\u03c4\u03b7 \u039a\u03b1\u03bd\u03b5\u03bb\u03bb\u03bf\u03c0\u03bf\u03cd\u03bb\u03bf\u03c5 - \u039c\u03b1\u03c1\u03af\u03bd\u03b1 \u03a0\u03ac\u03c4\u03c1\u03b1\u03c2"},{"id":148,"travelTimeSeconds":442,"condition":"Unknown","lastUpdate":"2014-09-12T17:26:06.8470000+00:00","title":"\u039a\u03b1\u03bb\u03b1\u03b2\u03c1\u03c5\u03c4\u03b9\u03bd\u03bf\u03cd \u039f\u03bb\u03bf\u03ba\u03b1\u03c5\u03c4\u03ce\u03bc\u03b1\u03c4\u03bf\u03c2 - \u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9"},{"id":146,"travelTimeSeconds":722,"condition":"Unknown","lastUpdate":"2014-06-13T08:28:00.4670000+00:00","title":"\u039a\u03b1\u03bb\u03b1\u03b2\u03c1\u03c5\u03c4\u03b9\u03bd\u03bf\u03cd \u039f\u03bb\u03bf\u03ba\u03b1\u03c5\u03c4\u03ce\u03bc\u03b1\u03c4\u03bf\u03c2 - \u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd"},{"id":144,"travelTimeSeconds":1390,"condition":"Unknown","lastUpdate":"2014-09-11T10:08:43.6670000+00:00","title":"\u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9 - \u03a0\u03b1\u03bd\u03b1\u03b3\u03b9\u03ce\u03c4\u03b7 \u039a\u03b1\u03bd\u03b5\u03bb\u03bb\u03bf\u03c0\u03bf\u03cd\u03bb\u03bf\u03c5"},{"id":141,"travelTimeSeconds":"","condition":"Unknown","lastUpdate":"","title":"\u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9-\u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd"},{"id":143,"travelTimeSeconds":556,"condition":"Unknown","lastUpdate":"2014-09-04T15:10:46.1870000+00:00","title":"\u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9 - \u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u0392\u03b1\u03c3\u03b9\u03bb\u03ad\u03c9\u03c2 \u0393\u03b5\u03c9\u03c1\u03b3\u03af\u03bf\u03c5"},{"id":140,"travelTimeSeconds":"","condition":"Unknown","lastUpdate":"","title":"\u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd - \u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9"},{"id":151,"travelTimeSeconds":286,"condition":"Unknown","lastUpdate":"2014-07-03T19:12:14.9300000+00:00","title":"\u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u039d\u03af\u03ba\u03b7\u03c2 - \u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd"},{"id":149,"travelTimeSeconds":444,"condition":"Congested","lastUpdate":"2014-10-07T15:27:23.8130000+00:00","title":"\u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u039d\u03af\u03ba\u03b7\u03c2 - \u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u0392\u03b1\u03c3\u03b9\u03bb\u03ad\u03c9\u03c2 \u0393\u03b5\u03c9\u03c1\u03b3\u03af\u03bf\u03c5"},{"id":145,"travelTimeSeconds":160,"condition":"Unknown","lastUpdate":"2014-07-03T22:27:35.1930000+00:00","title":"\u03a0\u03b1\u03c0\u03b1\u03c6\u03bb\u03ad\u03c3\u03c3\u03b1 - \u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd"},{"id":153,"travelTimeSeconds":115,"condition":"Unknown","lastUpdate":"2014-07-03T22:12:34.2970000+00:00","title":"\u039c\u03b1\u03c1\u03af\u03bd\u03b1 \u03a0\u03ac\u03c4\u03c1\u03b1\u03c2 - \u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd"},{"id":147,"travelTimeSeconds":573,"condition":"Unknown","lastUpdate":"2014-10-06T18:25:40.8930000+00:00","title":"\u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u0392\u03b1\u03c3\u03b9\u03bb\u03ad\u03c9\u03c2 \u0393\u03b5\u03c9\u03c1\u03b3\u03af\u03bf\u03c5 - \u039a\u03b1\u03bb\u03b1\u03b2\u03c1\u03c5\u03c4\u03b9\u03bd\u03bf\u03cd \u039f\u03bb\u03bf\u03ba\u03b1\u03c5\u03c4\u03ce\u03bc\u03b1\u03c4\u03bf\u03c2"},{"id":142,"travelTimeSeconds":390,"condition":"Unknown","lastUpdate":"2014-09-15T16:25:12.2930000+00:00","title":"\u03a0\u03bb\u03b1\u03c4\u03b5\u03af\u03b1 \u0392\u03b1\u03c3\u03b9\u03bb\u03ad\u03c9\u03c2 \u0393\u03b5\u03c9\u03c1\u03b3\u03af\u03bf\u03c5-\u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9"}]}

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

  • 140: "Τριών Συμμάχων - Νέο Λιμάνι";
  • 141: "Νέο Λιμάνι-Τριών Συμμάχων";
  • 142: "Πλατεία Βασιλέως Γεωργίου-Νέο Λιμάνι";
  • 143: "Νέο Λιμάνι - Πλατεία Βασιλέως Γεωργίου";
  • 144: "Νέο Λιμάνι - Παναγιώτη Κανελλοπούλου";
  • 145: "Παπαφλέσσα - Τριών Συμμάχων";
  • 146: "Καλαβρυτινού Ολοκαυτώματος - Τριών Συμμάχων";
  • 147: "Πλατεία Βασιλέως Γεωργίου - Καλαβρυτινού Ολοκαυτώματος";
  • 148: "Καλαβρυτινού Ολοκαυτώματος - Νέο Λιμάνι";
  • 149: "Πλατεία Νίκης - Πλατεία Βασιλέως Γεωργίου";
  • 150: "Παναγιώτη Κανελλοπούλου - Πλατεία Νίκης";
  • 151: "Πλατεία Νίκης - Τριών Συμμάχων";
  • 152: "Παναγιώτη Κανελλοπούλου - Μαρίνα Πάτρας";
  • 153: "Μαρίνα Πάτρας - Τριών Συμμάχων";

1.1. Κλήση υπηρεσίας
Η κλήση της υπηρεσίας γίνεται χρησιμοποιώντας HTTP requests με GET παραμέτρους και με πρώτη παράμετρο τη λέξη op. Στη συνέχεια συμπληρώνεται η πράξη που θέλουμε να εκτελεστεί καθώς οι όποιες συμπληρωματικές παράμετροι.

1.2. Διαθέσιμες Υπηρεσίες

  1. Εύρεση όλων των εκτιμώμενων διαδρομών
  2. Εύρεση μόνο των διαδρομών για τις οποίες υπάρχουν δεδομένα
  3. Εύρεση συγκεκριμένων διαδρομών
  4. Εύρεση μίας μόνο διαδρομής

 

1. Εύρεση όλων των εκτιμώμενων διαδρομών
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές, ακόμα και για αυτές για τις οποίες μπορεί να μην έχει δεδομένα ή να μην υπολογίζονται λόγω τεχνικών δυσκολιών (π.χ. κάποιος ανιχνευτής να είναι εκτός λειτουργίας)
Request
Παράμετροι:
op= GetAll
Παράδειγμα request http://quickweb.gr/itsweb/webservices/json?op=GetAll
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε json μορφή (unicode encoding). Αποτελείται από δύο μέρη: το id, και το result. Το id αφορά σε κωδικό λάθους και όσο έχει -1 σημαίνει πως το response είναι ορθό. Στο Result καταγράφεται ένας πίνακας κάθε γραμμή του οποίου αποτελεί μία εκτιμώμενη διαδρομή στη μορφή που περιγράφηκε αρχικά.
2. Εύρεση μόνο των διαδρομών για τις οποίες υπάρχουν δεδομένα
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές οι οποίες θεωρούνται ενεργές δηλαδή για τις οποίες υπάρχουν δεδομένα.
Request
Παράμετροι:
op=GetActive
Παράδειγμα request http://quickweb.gr/itsweb/webservices/json?op=GetActive
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε json μορφή (unicode encoding). Αποτελείται από δύο μέρη: το id, και το result. Το id αφορά σε κωδικό λάθους και όσο έχει -1 σημαίνει πως το response είναι ορθό. Στο Result καταγράφεται ένας πίνακας κάθε γραμμή του οποίου αποτελεί μία εκτιμώμενη διαδρομή στη μορφή που περιγράφηκε αρχικά.

3. Εύρεση συγκεκριμένων διαδρομών
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές οι όμως δίδονται από τον requestor
Request
Παράμετροι:
op= GetSelected
ids=141,144,153 (comma separated ids)
Παράδειγμα request http://quickweb.gr/itsweb/webservices/json?op=GetSelected&ids=141,144,153
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε json μορφή (unicode encoding). Αποτελείται από δύο μέρη: το id, και το result. Το id αφορά σε κωδικό λάθους και όσο έχει -1 σημαίνει πως το response είναι ορθό. Στο Result καταγράφεται ένας πίνακας κάθε γραμμή του οποίου αποτελεί μία εκτιμώμενη διαδρομή στη μορφή που περιγράφηκε αρχικά.

4. Εύρεση συγκεκριμένης διαδρομής
Επιστρέφει στοιχεία για μία μόνο διαδρομή
Request
Παράμετροι:
op= GetDetails
id=141
Παράδειγμα request http://quickweb.gr/itsweb/webservices/json?op=GetDetails&id=141
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε json μορφή (unicode encoding). Αποτελείται από δύο μέρη: το id, και το result. Το id αφορά σε κωδικό λάθους και όσο έχει -1 σημαίνει πως το response είναι ορθό. Στο Result καταγράφεται ένας πίνακας κάθε γραμμή του οποίου αποτελεί μία εκτιμώμενη διαδρομή στη μορφή που περιγράφηκε αρχικά.