mobile

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

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

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

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

 {"id":-1,"result":[{"id":"aVYvEvdxQ\/3T6Qw4OuIWi8GXOVDj0mRuywLYBf+0l+w=","travelTimeSeconds":"86E7KA7biUnNASnvMyLLusqS6uN3gZYvHplzdY7Rlck=", "condition":"NlyE6LlGrxgDQ5o2FdypeNdBUB4tglo1udWRvNpqzB8=",   "lastUpdate":"s9HgjTtmlghVw1RqD5DjC4wOlsdHNZxNYL7r+Eh1H+PcUbIK6WBxiuH8xfBAqnhdPCwTVoMZKBnSmA3wTiws9w==", "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":"TXfE3V+KYESnVKq6jsJzAGiU\/FW8ztJrl0av51vkk8s=", "travelTimeSeconds":"JAdqwDIjHIl8A\/4e363Qy8EQ\/3Ly+TXQUHRP5CJjXuM=", "condition":"NlyE6LlGrxgDQ5o2FdypeNdBUB4tglo1udWRvNpqzB8=", "lastUpdate":"s9HgjTtmlghVw1RqD5DjC4wOlsdHNZxNYL7r+Eh1H+PcUbIK6WBxiuH8xfBAqnhdPCwTVoMZKBnSmA3wTiws9w==","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":"XDwobibeAsbYH8kgXUUt0mHKa3ym2wTirJTFIzNRgOw=","travelTimeSeconds":"Z2UHDXooINu\/JHFE+mFYp4AYCxz3FABUy7jn57gMRrM=", "condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=","lastUpdate":"PkdNtj\/m8acyH5SzzYHedp2Cuz\/QDiBEpApJni0PMynh3on9rIntijgCWt3Au0ki5fgvbsrhc2SoEAQY8zIW5A==", "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":"NMtFHtzUMzkChu007ZvconARWtqzsG2V2Z\/Vdrnjk6w=", "travelTimeSeconds":"hhnAfAQUmcSuaKUCpqcTDm+sbsQnKaMIdyIs4bc44tQ=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=", "lastUpdate":"epJgQMtdgCGWH5qfIrRyj0WLQQv9XZs98G5uPMhYJMQW+OX1X6fIrUgvtDcdt2W6zFkPlqAvPBd1mMAh\/ako0g==", "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":"72NPQCYSn7TdAIvRI\/\/0mCJZGCxWOJn5vo1RRYzCsKo=","travelTimeSeconds":"Fq+bz1YwRwECvz1Fzsza5+IMfJFZoQV3a4ZBVzUQXSE=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=", "lastUpdate":"3Lz3uES9beZ5yOPqkHwssrOyLZ29wivPNfdOFFs8pBaAhqg6RXusqiglNkQtKWMjtQEC2JxLYGF\/otN82MHkYg==", "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":"hsGvfDaGusYmMUiBIRrFfpmOKJ9rEi+K5mZ3rxBpM2M=","travelTimeSeconds":"TACyVtQFveJfYto58Xp0fze3svxmOCaEMBtLk2EHQnA=", "condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=", "lastUpdate":"TACyVtQFveJfYto58Xp0fze3svxmOCaEMBtLk2EHQnA=","title":"\u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9-\u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd"},{"id":"Vht47saXxyypaEq\/mBe+usc0ZivdhFgOSYuh1Phjggo=", "travelTimeSeconds":"yTwKlfgM\/l0J+CDPFTudYrW6L+ur5dOkkrUXnvH0rSs=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=","lastUpdate":"dW141eMPpOLJyLoKIMgmlzZgaqrahorZINxD3JLYS1866OiLh+lylaSw2rC50d5ene6V35VmPaSlhCig7bbitQ==", "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":"6D0HOVQhXuwaLSzNZuE+sOuccCnhbhpzvTaOa74kbPU=","travelTimeSeconds":"TACyVtQFveJfYto58Xp0fze3svxmOCaEMBtLk2EHQnA=", "condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=","lastUpdate":"TACyVtQFveJfYto58Xp0fze3svxmOCaEMBtLk2EHQnA=", "title":"\u03a4\u03c1\u03b9\u03ce\u03bd \u03a3\u03c5\u03bc\u03bc\u03ac\u03c7\u03c9\u03bd - \u039d\u03ad\u03bf \u039b\u03b9\u03bc\u03ac\u03bd\u03b9"},{"id":"cACezzuv1bocb8HVcGGDa9qnOCG20ZX8EFUe\/gonnTc=", "travelTimeSeconds":"xEprfugtBVXLvrW5hanm68IkS5CRGYwX\/eHQ7vFYCQE=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=","lastUpdate":"sXcy8FEianCkZnTdgDi8OhyMAhkk1icPUyClsVYoAqwgs8KrS0F9gBmzMKdS1mYVRWeNUaCH1zS\/lZiIA6keSQ==", "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":"VBy7pRpQ1pBHQVVQ75tgn3gID+dmz8hwMB\/JO0C2mGo=","travelTimeSeconds":"90BnbcqIdR9rtIATW5tAKotZnZY7Fa6BYlzmAmSg28U=", "condition":"GpNGHCq6+5mi+qD6KdFBsN4aN8U4w07d+UmQCp7wSRg=", "lastUpdate":"s9HgjTtmlghVw1RqD5DjC4wOlsdHNZxNYL7r+Eh1H+PcUbIK6WBxiuH8xfBAqnhdPCwTVoMZKBnSmA3wTiws9w==","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":"XXwVSeFJsyjqGC6nEUepfUPGQN\/vyaQ8PwN32JiEMr0=", "travelTimeSeconds":"t8C4JNNYl4ifwU0I7Io374pvgmipHYDmjzv1LFt1+gs=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=", "lastUpdate":"A7Ai5mQgzz37PEQQQlW55YGc4GzZ+be60WTH+R\/CyPG01b3Qi4G2+AGfYGgXUXx5huWGU8\/IBI3js6kBVP3WEQ==", "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":"ACJIh4954xWCKsrlMu2mnRVTn\/jAdjX0Br26v8PEacI=","travelTimeSeconds":"iYwboBucmHGXCgcXZ\/X0HxxXKdHkLV5q\/muzJWg6yRk=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=", "lastUpdate":"PDB8rcwnBNc2bT62O6yV1RJuDpBSlmG7dBwayndV7vzOMbLlDgfEfnpC0UL+456xQ5COGzGlR9SAbl3h3518hA==", "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":"qpSuFtZgey12rzN9a24UKUHbizOLyO4NlI5pzkxKs18=", "travelTimeSeconds":"mg8+iBljLOxZczFLdILqI+\/8eetl3U5ueGHMUbLtjTY=","condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=","lastUpdate":"jK16kU9ghO9ucW\/wD6YAcFSFmMUIe6r+z2zHVkzeMVoC3Zb5BZ9DM4ZaaCgLS\/CSRJBPnwP1tW8p+n7Wd8Jqtg==", "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":"L10aeabG6Q2OdMhIPjjG09R9iTuSKP3rnNF\/Co4cR5Q=", "travelTimeSeconds":"FKUhuKiUchi2dpC79RvOS1wRf7wQV2mT4JkTP54Yfq4=", "condition":"IarIvMHJqlUXo1xOTMwdngZ0Vguac\/1AIE7ajwLS93Q=","lastUpdate":"OnY\/Bn4hs4PcaA3cvHF0ttBrzvfp7o+Vp6g1YAwbamUfqc\/Vf2M6vFx\/31VbKLlnfaGIUTfCDqSB0\/eWOJLQiQ==", "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. Κλήση υπηρεσίας
Η κλήση της υπηρεσίας γίνεται χρησιμοποιώντας αποκλειστικά και μόνο HTTPS requests διασφαλίζοντας με αυτόν τον τρόπο θέματα ασφάλειας στην αλληλεπίδραση μεταξύ πελάτη και υπηρεσίας. Η υπηρεσία δέχεται GET παραμέτρους με πρώτη παράμετρο τη λέξη op. Στη συνέχεια συμπληρώνεται η πράξη που θέλουμε να εκτελεστεί καθώς οι όποιες συμπληρωματικές παράμετροι. Όπως αναφέρθηκε παραπάνω, τα αποτελέσματα της υπηρεσίας, παρόλο που είναι σε JSON μορφή έρχονται και αυτά κρυπτογραφημένα έτσι ώστε μόνο με τη χρήση ειδικού κλειδιού να επιτρέπεται η αποκρυπτογράφηση και η τελική χρήση τους.
Η διαδικασία υποστήριξης της ασφάλειας και της κρυπτογράφησης των δεδομένων γίνεται για μελλοντική χρήση και προς το παρόν διατίθεται μόνο για λόγους επίδειξης.

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

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

1. Εύρεση όλων των εκτιμώμενων διαδρομών
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές, ακόμα και για αυτές για τις οποίες μπορεί να μην έχει δεδομένα ή να μην υπολογίζονται λόγω τεχνικών δυσκολιών (π.χ. κάποιος ανιχνευτής να είναι εκτός λειτουργίας)

Request
Παράμετροι:
op=GetAll
Παράδειγμα request https://quickweb.gr/itsweb/webservices/jsonEncrypted?op=GetAll

Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε json μορφή (unicode encoding). Αποτελείται από δύο μέρη: το id, και το result. Το id αφορά σε κωδικό λάθους και όσο έχει -1 σημαίνει πως το response είναι ορθό. Στο Result καταγράφεται ένας πίνακας κάθε γραμμή του οποίου αποτελεί μία εκτιμώμενη διαδρομή στη μορφή που περιγράφηκε αρχικά.

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

Request
Παράμετροι:
op=GetActive
Παράδειγμα request https://quickweb.gr/itsweb/webservices/jsonEncrypted?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 https://quickweb.gr/its/webservices/jsonEncrypted?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 https://quickweb.gr/itsweb/webservices/jsonEncrypted?op=GetDetails&id=141

Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε json μορφή (unicode encoding). Αποτελείται από δύο μέρη: το id, και το result. Το id αφορά σε κωδικό λάθους και όσο έχει -1 σημαίνει πως το response είναι ορθό. Στο Result καταγράφεται ένας πίνακας κάθε γραμμή του οποίου αποτελεί μία εκτιμώμενη διαδρομή στη μορφή που περιγράφηκε αρχικά.