Patras Traffic web service (datexII-like) τεκμηρίωση.
1.1. To DatexII format
Με στόχο την υποστήριξη της βιώσιμης κινητικότητας στην Ευρώπη, η Ευρωπαϊκή Επιτροπή υποστηρίζει την ανταλλαγή πληροφοριών, κυρίως μεταξύ των παραγόντων του τομέα διαχείρισης της οδικής κυκλοφορίας για μια σειρά ετών. Στον τομέα των οδικών μεταφορών, το πρότυπο DATEX αναπτύχθηκε για την ανταλλαγή πληροφοριών μεταξύ των κέντρων διαχείρισης της κυκλοφορίας, τα κέντρα πληροφοριών για την κυκλοφορία και τους παρόχους υπηρεσιών και αποτελεί το σημείο αναφοράς για τις εφαρμογές που έχουν αναπτυχθεί τα τελευταία 10 χρόνια. Η προδιαγραφή δεύτερης γενιάς DATEX ΙΙ αποτελεί το νέο πρότυπο για φορείς στην κυκλοφορία και τις μετακινήσεις του τομέα της πληροφόρησης.
Το πρότυπο DATEX αρχικά σχεδιάστηκε και αναπτύχθηκε ως ένας μηχανισμός ανταλλαγής δεδομένων κυκλοφορίας από μια ευρωπαϊκή ειδική ομάδα που έχει συσταθεί για να τυποποιηθεί η διεπαφή μεταξύ του ελέγχου της κυκλοφορίας και των κέντρων πληροφόρησης. Με τη νέα έκδοσή του το DATEX ΙΙ έχει γίνει το σημείο αναφοράς για όλες τις εφαρμογές που απαιτούν πρόσβαση σε δυναμική κίνηση και τα ταξίδια που σχετίζονται με τις πληροφορίες στην Ευρώπη. Περισσότερες πληροφορίες μπορείτε να βρείτε στο www.datex2.eu
Επειδή το πρότυπο DATEXII αφορά σε ένα μεγάλο σύνολο από δεδομένα κίνησης η παρούσα εφαρμογή χρησιμοποίησε ένα τμήμα από το σχήμα DATEXIISchema_2_2_0.xsd το οποίο αφορά σε χρονικές εκτιμήσεις για συγκεκριμένες αποστάσεις. Η κωδικοποίηση των σημείων και των διαδρομών μεταξύ τους είναι αποτέλεσμα εθνικής δράσης. Η αντίστοιχη κωδικοποίηση στο πλαίσιο του συγκεκριμένου έργου ΔΕΝ ήταν διαθέσιμη και ως εκ τούτου δεν ήταν δυνατή η χρήση πραγματικών σημείων αναφοράς για τις συγκεκριμένες διαδρομές. Παρόλα αυτά επειδή το πρότυπο DatexΙΙ θα υποστηριχθεί πλήρως στο μέλλον και από την Ελλάδα η συγκεκριμένη υπηρεσία παρέχει σε μορφή DatexII-Like τα δεδομένα της ως παράδειγμα χρήσης. Εφόσον υπάρξει σαφής κωδικοποίηση των διαδρομών η υπηρεσία θα ενημερωθεί κατάλληλα.
Η υπηρεσία επιστρέφει σε DatexII-like μορφή πληροφορίες για τον εκτιμώμενο χρόνο διαδρομών. Οι πληροφορίες αυτές αφορούν στα κάτωθι:
- Κωδικός διαδρομής: μία αυτοματοποιημένη κωδικοποίηση για κάθε ξεχωριστή διαδρομή που ορίζεται από δύο σημεία ανιχνευτών
- Εκτιμώμενος χρόνος σε δευτερόλεπτα
- Ημερομηνία και ώρα τελευταίας ενημέρωσης.
Κάθε απόκριση περιέχει –ανάλογα με τις παραμέτρους κλήσης- ένα σύνολο από πληροφορίες διαδρομών. Έτσι, για παράδειγμα, μία κλήση για ενημέρωση για όλες τις διαδρομές μπορεί να φέρει ένα αποτέλεσμα σαν το κάτωθι:
<xml version="1.0" encoding="UTF-8">
<d2LogicalModel xsi:schemaLocation="http://datex2.eu/schema/2/2_0 ..\..\Schema\DATEXIISchema_2_2_0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://datex2.eu/schema/2/2_0" modelBaseVersion="2">
<exchange>
<supplierIdentification>
<country>gr</country>
<nationalIdentifier>ITS_Greece</nationalIdentifier>
</supplierIdentification>
</exchange>
<payloadPublication xsi:type="ElaboratedDataPublication" lang="gr">
<publicationTime>2014-11-11 09:25:22</publicationTime>
<publicationCreator>
<country>gr</country>
<nationalIdentifier>Patras_ITS</nationalIdentifier>
</publicationCreator>
<headerInformation>
<confidentiality>noRestriction</confidentiality>
<informationStatus>real</informationStatus>
</headerInformation>
<elaboratedData>
<basicData xsi:type="TravelTimeData">
<measurementOrCalculationTime>2014-11-11T08:22:08.8930000+00:00</measurementOrCalculationTime>
<pertinentLocation xsi:type="Linear">
<alertCLinear xsi:type="AlertCMethod2Linear">
<alertCLocationCountryCode>1</alertCLocationCountryCode>
<alertCLocationTableNumber>1</alertCLocationTableNumber>
<alertCLocationTableVersion>1</alertCLocationTableVersion>
<alertCDirection>
<alertCDirectionCoded>positive</alertCDirectionCoded>
</alertCDirection>
<alertCMethod2PrimaryPointLocation>
<alertCLocation>
<specificLocation>150</specificLocation>
<specificLocation>150</specificLocation>
</alertCLocation>
</alertCMethod2PrimaryPointLocation>
<alertCMethod2SecondaryPointLocation>
<alertCLocation>
<specificLocation>150</specificLocation>
<specificLocation>150</specificLocation>
</alertCLocation>
</alertCMethod2SecondaryPointLocation>
</alertCLinear>
</pertinentLocation>
<travelTimeTrendType>increasing</travelTimeTrendType>
<travelTime>
<duration>242</duration>
</travelTime>
<freeFlowTravelTime>
<duration/>
</freeFlowTravelTime>
<freeFlowSpeed>
<speed/>
</freeFlowSpeed>
</basicData>
</elaboratedData>
</payloadPublication>
</d2LogicalModel>
</xml>
Παρακάτω αναφέρονται οι κωδικοί διαδρομής. Οι κωδικοί μπορούν να αλλάξουν καθώς επίσης και να προστεθούν και άλλοι με νέες διαδρομές.
- 140: "Τριών Συμμάχων - Νέο Λιμάνι";
- 141: "Νέο Λιμάνι-Τριών Συμμάχων";
- 142: "Πλατεία Βασιλέως Γεωργίου-Νέο Λιμάνι";
- 143: "Νέο Λιμάνι - Πλατεία Βασιλέως Γεωργίου";
- 144: "Νέο Λιμάνι - Παναγιώτη Κανελλοπούλου";
- 145: "Παπαφλέσσα - Τριών Συμμάχων";
- 146: "Καλαβρυτινού Ολοκαυτώματος - Τριών Συμμάχων";
- 147: "Πλατεία Βασιλέως Γεωργίου - Καλαβρυτινού Ολοκαυτώματος";
- 148: "Καλαβρυτινού Ολοκαυτώματος - Νέο Λιμάνι";
- 149: "Πλατεία Νίκης - Πλατεία Βασιλέως Γεωργίου";
- 150: "Παναγιώτη Κανελλοπούλου - Πλατεία Νίκης";
- 151: "Πλατεία Νίκης - Τριών Συμμάχων";
- 152: "Παναγιώτη Κανελλοπούλου - Μαρίνα Πάτρας";
- 153: "Μαρίνα Πάτρας - Τριών Συμμάχων";
1.2. Κλήση υπηρεσίας
Η κλήση της υπηρεσίας γίνεται χρησιμοποιώντας HTTP requests με GET παραμέτρους και με πρώτη παράμετρο τη λέξη op. Στη συνέχεια συμπληρώνεται η πράξη που θέλουμε να εκτελεστεί καθώς οι όποιες συμπληρωματικές παράμετροι.
1.3. Διαθέσιμες Υπηρεσίες
- Εύρεση όλων των εκτιμώμενων διαδρομών
- Εύρεση μόνο των διαδρομών για τις οποίες υπάρχουν δεδομένα
- Εύρεση συγκεκριμένων διαδρομών
- Εύρεση μίας μόνο διαδρομής
1. Εύρεση όλων των εκτιμώμενων διαδρομών
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές, ακόμα και για αυτές για τις οποίες μπορεί να μην έχει δεδομένα ή να μην υπολογίζονται λόγω τεχνικών δυσκολιών (π.χ. κάποιος ανιχνευτής να είναι εκτός λειτουργίας)
Request
Παράμετροι:
op= GetAll
Παράδειγμα request http://quickweb.gr/itsweb/webservices/datex?op=GetAll
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε datexII-like μορφή (utf8 encoding).
2. Εύρεση μόνο των διαδρομών για τις οποίες υπάρχουν δεδομένα
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές οι οποίες θεωρούνται ενεργές δηλαδή για τις οποίες υπάρχουν δεδομένα.
Request
Παράμετροι:
op= GetActive
Παράδειγμα request http://quickweb.gr/itsweb/webservices/datex?op=GetActive
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε datexII-like μορφή (utf8 encoding).
3. Εύρεση συγκεκριμένων διαδρομών
Επιστρέφει λίστα με όλες τις εκτιμώμενες διαδρομές οι όμως δίδονται από τον requestor
Request
Παράμετροι:
op= GetSelected
ids=141,144,153 (comma separated ids)
Παράδειγμα request http://quickweb.gr/itsweb/webservices/datex?op=GetSelected&ids=141,144,153
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε datexII-like μορφή (utf8 encoding).
4. Εύρεση συγκεκριμένης διαδρομής
Επιστρέφει στοιχεία για μία μόνο διαδρομή
Request
Παράμετροι:
op= GetDetails
id=141
Παράδειγμα request http://quickweb.gr/itsweb/webservices/datex?op=GetDetails&id=141
Response
Σε περίπτωση που δεν δοθεί καθόλου η op τότε το σύστημα θεωρεί πως δίδεται το GetAll.
Το Response επιστρέφεται σε datexII-like μορφή (utf8 encoding).