Άγνωστη τιμή – null
Έλλειψη γνωστής τιμής σε σύμβαση που χρησιμοποιεί null γι’ αυτό το νόημα. Δεν πρέπει να αντικαθίσταται με μηδέν, ψευδές ή απόδειξη απουσίας.
Παράδειγμα
Μετρητής ποδηλάτων null δεν σημαίνει άδειο σταθμό.
Γλωσσάριο ROOTE
Το γλωσσάριο της κινητικότητας και των δεδομένων.
Απλοί ορισμοί για να κατανοήσετε τις μεταφορές, τις υπηρεσίες γειτονιάς και τα εργαλεία που τις συνδέουν με τις εφαρμογές σας.
79 ορισμοί που εμφανίζονται
Α
Ακτίνα αναζήτησης
Απόσταση γύρω από το σημείο εκκίνησης που οριοθετεί την αναζήτηση. Η μονάδα και τα όρια εξαρτώνται από τη σύμβαση του endpoint ή εργαλείου.
Παράδειγμα
radius=600 ζητά ακτίνα 600 μέτρων στο παράδειγμα REST.
Αναφορά πηγής
Αναγραφή παρόχου ή πηγής δεδομένων. Όταν απαιτείται, η εφαρμογή που χρησιμοποιεί το αποτέλεσμα πρέπει να την εμφανίζει.
Παράδειγμα
Η υποχρεωτική αναφορά πρέπει να διατηρείται στη διεπαφή.
Αντίστροφη γεωκωδικοποίηση
Αναζητήσεις τοποθεσιών ή ετικετών από συντεταγμένες. Το αποτέλεσμα μπορεί να αντιπροσωπεύει κοντινή τοποθεσία και όχι ακριβή διεύθυνση.
Παράδειγμα
Σημείο GPS αντιστοιχίζεται σε αναγνώσιμη ετικέτα.
Ανωμαλία
Γεγονός που επηρεάζει υπηρεσία μεταφοράς, όπως διακοπή ή αλλαγή διαδρομής. Τα αποτελέσματα διαβάζονται εντός του περιεχομένου και χρονικού διαστήματος που αναφέρονται.
Παράδειγμα
Μια ειδοποίηση μπορεί να αφορά μόνο μια γραμμή και συγκεκριμένες ώρες.
Απάντηση βασισμένη σε δεδομένα – grounding
Κατασκευή απάντησης από πραγματικά ανακτημένες ή δοσμένες πληροφορίες. Ελλείποντα πεδία και επιφυλάξεις πρέπει να παραμένουν ορατά.
Παράδειγμα
Ο βοηθός αναπαράγει τα επιστρεφόμενα σημεία χωρίς εφεύρεση ωραρίων.
Αστική υπηρεσία
Εξοπλισμός ή υπηρεσία κοντά σε σημείο, όπως τουαλέτες, σημείο νερού ή σταθμός φόρτισης. Τα χαρακτηριστικά της μπορεί να είναι ελλιπή.
Παράδειγμα
Αποτέλεσμα κοντινότητας περιγράφει μια υπηρεσία και διαθέσιμες πληροφορίες.
Άτομα με μειωμένη κινητικότητα – ΑΜΚ
Άτομο με δυσκολίες κινητικότητας μόνιμες ή προσωρινές. Η ένδειξη ΑΜΚ δεν περιγράφει από μόνη της όλα τα αναγκαία προσβάσεις ή εξοπλισμό.
Παράδειγμα
Η παρουσία ράμπας δεν εξαλείφει όλα τα πιθανά εμπόδια.
Γ
Γεωγραφική απόσταση
Απόσταση υπολογισμένη μεταξύ θέσεων βάσει της μεθοδολογίας της υπηρεσίας. Δεν είναι αυτόματα σύνολο διαδρομής ή χρόνος πεζοπορίας.
Παράδειγμα
Κοντινή τοποθεσία μπορεί να απαιτεί παράκαμψη για πρόσβαση.
Γεωγραφικό μήκος
Συντεταγμένη που εκφράζει θέση ανατολικά ή δυτικά του βασικού μεσημβρινού. Στα παραδείγματα ROOTE χρησιμοποιούνται μοίρες μεταξύ −180 και 180.
Παράδειγμα
Το γεωγραφικό μήκος μπορεί να μεταβιβαστεί ως lon ή ως το ντοκιουμενταρισμένο alias lng.
Γεωγραφικό πλάτος
Συντεταγμένη που εκφράζει θέση βόρεια ή νότια του ισημερινού, σε μοίρες σύμφωνα με τα παραδείγματα ROOTE. Η τιμή κυμαίνεται μεταξύ −90 και 90.
Παράδειγμα
Το γεωγραφικό πλάτος του σημείου αναζήτησης μεταβιβάζεται στο lat.
Γεωκωδικοποίηση
Αναζήτηση που μετατρέπει διεύθυνση ή γεωγραφική έκφραση σε υποψήφιες τοποθεσίες με συντεταγμένες. Πολλές τοποθεσίες μπορεί να αντιστοιχούν στην ίδια είσοδο.
Παράδειγμα
Δύο πόλεις έχουν δρόμο με το ίδιο όνομα.
Γεωτοποθεσία
Λήψη γεωγραφικής θέσης μέσω συσκευής ή εφαρμογής. Εξαρτάται από δικαιώματα και διαθεσιμότητα ακρίβειας.
Παράδειγμα
Το κουμπί εντοπισμού ζητά άδεια από τον browser.
Γραμμή
Ταυτοποιημένη υπηρεσία μεταφοράς εντός δικτύου με ένα ή περισσότερα δρομολόγια ή παραλλαγές. Το όνομα της γραμμής δεν αρκεί για να καθορίσει τη σωστή κατεύθυνση.
Παράδειγμα
Ίδια γραμμή μπορεί να έχει πολλαπλούς τερματικούς σταθμούς.
Δ
Δεδομένα σε πραγματικό χρόνο
Ενημερωμένες πληροφορίες που περιγράφουν πρόσφατη κατάσταση ή υποστηρίζουν εκτίμηση. Η φρεσκάδα πρέπει να αξιολογείται· πραγματικός χρόνος δεν σημαίνει στιγμιαία ή εγγυημένη.
Παράδειγμα
Εκτίμηση διέλευσης επαναυπολογίζεται από πρόσφατα δεδομένα.
Δημόσιες τουαλέτες
Τουαλέτες για κοινή χρήση σύμφωνα με τις τοπικές συνθήκες. Η παρουσία στα δεδομένα δεν εγγυάται δωρεάν χρήση, άνοιγμα ή προσβασιμότητα.
Παράδειγμα
Ελέγξτε τις αναφερόμενες συνθήκες πριν μεταβείτε.
Διαθεσιμότητα
Κατάσταση ή ποσότητα που δείχνει τι μπορεί να χρησιμοποιηθεί βάσει γνωστών πληροφοριών. Η παρατηρούμενη διαθεσιμότητα μπορεί να αλλάξει και δεν ισοδυναμεί με κράτηση.
Παράδειγμα
Τρία ποδήλατα που παρατηρούνται σε σταθμό δεν σημαίνουν πως είναι τρία κρατημένα.
Διακομιστής MCP
Πρόγραμμα που εκθέτει ικανότητες σύμφωνα με MCP. Τα πραγματικά διαθέσιμα εργαλεία καθορίζουν τι μπορεί να καλεί ο πελάτης.
Παράδειγμα
tools/list επιτρέπει προβολή διαθέσιμου αποθέματος.
Διακριτικό Bearer
Αναγνωριστικό πρόσβασης σε κεφαλίδα Authorization σύμφωνα με προβλεπόμενο μηχανισμό. Πρέπει να φυλάσσεται με ασφάλεια.
Παράδειγμα
Authorization: Bearer χρησιμοποιείται χωρίς δημοσιοποίηση διακριτικού σε URL.
Διαμορφωτής εφαρμογής MCP
Εφαρμογή που φιλοξενεί διαχείριση αλληλεπίδρασης με χρήστη και ελέγχει έναν ή περισσότερους πελάτες MCP. Παραμένει υπεύθυνη για χρήση αποτελεσμάτων στην εμπειρία.
Παράδειγμα
Η συνομιλιακή εφαρμογή σας συνδέει διακομιστή ROOTE.
Διάρκεια εγκυρότητας – TTL
Χρόνος που χρησιμοποιείται για τη διαχείριση εγκυρότητας ή ανανέωσης κρυφόμητος δεδομένων σύμφωνα με σύμβαση. Δεν αποδεικνύει την ώρα παρατήρησης πηγής.
Παράδειγμα
Ένα ληγμένο cache πρέπει να ακολουθεί πολιτική ανανέωσης.
Διατροπικότητα
Διαδοχική χρήση πολλών μέσων μετακίνησης σε ένα ταξίδι. Κάθε στάδιο διατηρεί τα δικά του ωράρια, πρόσβαση και όρους.
Παράδειγμα
Φτάνετε με ποδήλατο στο τραμ και συνεχίζετε πεζοί.
Δρομολόγιο
Εκτέλεση υπηρεσίας μεταφοράς με συγκεκριμένο δρομολόγιο και στάσεις. Στο GTFS, ένα δρομολόγιο συνδέεται με μια γραμμή και ένα ημερολόγιο υπηρεσίας.
Παράδειγμα
Δύο διαδοχικές αφετηρίες της ίδιας γραμμής αντιστοιχούν σε δύο δρομολόγια.
Ε
Εισαγωγή εντολής (prompt injection)
Προσπάθεια χρήσης εξωτερικού περιεχομένου για αλλαγή οδηγιών βοηθού. Οι περιγραφές παρόχων πρέπει να παραμένουν δεδομένα, όχι εντολές.
Παράδειγμα
Κρυφή εντολή σε όνομα τοποθεσίας δεν πρέπει να εκτελείται.
Εκτιμώμενη ώρα
Πρόβλεψη μελλοντικής διέλευσης υπολογισμένη από διαθέσιμες πληροφορίες. Μπορεί να ενημερώνεται όταν έρχονται νέα δεδομένα.
Παράδειγμα
Μια διέλευση προγραμματισμένη για τις 8:10 τώρα εκτιμάται στις 8:14.
Ενοικίαση ποδηλάτου δημόσιας χρήσης
Υπηρεσία που επιτρέπει προσωρινή χρήση ποδηλάτου σύμφωνα με τους όρους του παρόχου. Μπορεί να λειτουργεί με σταθμούς ή οχήματα χωρίς σταθμό.
Παράδειγμα
Εντοπίζετε ένα ποδήλατο και χρησιμοποιείτε την αντίστοιχη υπηρεσία ενοικίασης.
Επιστροφή
Λήξη χρήσης οχήματος σύμφωνα με τους κανόνες της υπηρεσίας. Οι δυνατότητες επιστροφής μπορεί να διαφέρουν από τις δυνατότητες παραλαβής.
Παράδειγμα
Ένας σταθμός επιτρέπει αναχώρηση αλλά δεν έχει θέση επιστροφής.
Επόμενη αναχώρηση
Επερχόμενη διέλευση ή αναχώρηση για σημείο και υπηρεσία. Η εύρεση στάσης δεν αποτελεί αναζήτηση επερχόμενων αναχωρήσεων.
Παράδειγμα
Οι λίστες στάσεων και αναχωρήσεων είναι δύο διακριτά αποτελέσματα.
Εργαλείο MCP
Εκτελέσιμη ικανότητα περιγραφόμενη με όνομα, λειτουργία και σχήμα παραμέτρων. Ο βοηθός πρέπει να χρησιμοποιεί αποδεκτές εισόδους κατά το σχήμα.
Παράδειγμα
geocode δέχεται διεύθυνση· transit_nearby δέχεται συντεταγμένες.
Ζ
Ζουμ χάρτη
Επίπεδο μεγέθυνσης προβολής χάρτη. Ελέγχει την εμφάνιση αλλά δεν αντικαθιστά την ακτίνα σε API ερώτηση.
Παράδειγμα
zoom=15 φέρνει την προβολή πιο κοντά στον χάρτη.
Η
Ηλεκτρικό ποδήλατο υποβοήθησης
Ποδήλατο με κινητήρα που βοηθά την πεταλιέρα σύμφωνα με τα χαρακτηριστικά του. Στα δεδομένα κινητικότητας, ο τύπος πρόωσης και η μπαταρία μπορεί να αναφέρονται ξεχωριστά.
Παράδειγμα
Ένας σταθμός μπορεί να διαχωρίζει τα μηχανικά από τα ηλεκτρικά ποδήλατα.
Ημερολόγιο υπηρεσίας
Πληροφορίες που περιγράφουν τις ημέρες λειτουργίας μεταφορικής υπηρεσίας με πιθανές εξαιρέσεις. Τα ωράρια ερμηνεύονται σε συνδυασμό με αυτό το ημερολόγιο.
Παράδειγμα
Μια διέλευση καθημερινή μπορεί να μη λειτουργεί Κυριακή.
Θ
Θέση αγκύρωσης
Εξοπλισμός σε ένα σταθμό όπου μπορεί να δέσει ένα ποδήλατο. Η ύπαρξή του δεν εγγυάται ότι δέχεται επιστροφή τη στιγμή της ερώτησης.
Παράδειγμα
Η θέση επιστροφής πρέπει να είναι διαθέσιμη και χρησιμοποιήσιμη.
Κ
Κάλυψη
Περιοχή και βαθμός πληρότητας διαθέσιμων πληροφοριών για αναζήτηση ή πηγή. Μερική κάλυψη περιορίζει τις δυνατές εξαγωγές.
Παράδειγμα
Λίστα μπορεί να είναι χρήσιμη χωρίς να αντιπροσωπεύει όλες τις υπηρεσίες.
Κατάσταση HTTP
Κωδικός που δείχνει αποτέλεσμα αίτησης στο επίπεδο HTTP. Πρέπει να συμπληρώνεται από επιβεβαίωση περιεχομένου και κατάστασης υπηρεσίας.
Παράδειγμα
HTTP 200 μπορεί να περιέχει κατάσταση υπηρεσίας με σφάλμα.
Κενό αποτέλεσμα – empty
Αναζήτηση που δεν επιστρέφει οντότητα εντός ερωτώμενου πεδίου. Δεν αποδεικνύει φυσική απουσία υπηρεσιών εκτός των διαθέσιμων πληροφοριών.
Παράδειγμα
Καμία στάση δεν βρέθηκε με τα ζητούμενα φίλτρα.
Κοινόχρηστη κινητικότητα
Σύνολο υπηρεσιών που παρέχουν πρόσβαση σε οχήματα που χρησιμοποιούνται διαδοχικά από πολλούς, αντί για ένα που ανήκει αποκλειστικά σε έναν ιδιοκτήτη.
Παράδειγμα
Ποδήλατα και πατίνια διαθέσιμα για ενοικίαση στην πόλη.
Λ
Ληγμένα δεδομένα – stale
Πληροφορία θεωρούμενη πολύ παλιά σύμφωνα με συμβόλαιο ή πολιτική εγκυρότητας. Μπορεί να διατηρείται ως ιστορικό, χωρίς να θεωρείται φρέσκια.
Παράδειγμα
Η διεπαφή δείχνει ότι η διαθεσιμότητα πρέπει να ανανεωθεί.
Μ
Μερική απάντηση – partial
Αποτέλεσμα με χρήσιμες πληροφορίες αλλά με όρια ή γνωστοποιημένα ελλείποντα στοιχεία. Πρέπει να συνοδεύεται από σχετικά προειδοποιητικά μηνύματα.
Παράδειγμα
Μια πηγή απαντά ενώ άλλη είναι μη διαθέσιμη.
Μεταφορά
Αλλαγή υπηρεσίας ή μέσου κατά τη διάρκεια ενός ταξιδιού. Η εγγύτητα δύο στάσεων δεν εγγυάται την πρακτική δυνατότητα μεταφοράς.
Παράδειγμα
Απαιτείται χρόνος για τη μετακίνηση ανάμεσα σε πλατφόρμες και την αναμονή.
Μόνο ανάγνωση
Ικανότητα προβολής χωρίς αλλαγή μέσω εργαλείου. Η ανάγνωση διαθεσιμότητας δεν προκαλεί κράτηση, ξεκλείδωμα ή ενοικίαση οχήματος.
Παράδειγμα
Τα εργαλεία δεδομένων ROOTE χρησιμοποιούνται για ενημέρωση πληροφοριών.
Ν
Νερό πόσιμου
Νερό που χαρακτηρίζεται κατάλληλο για ανθρώπινη κατανάλωση. Πηγή νερού ή βρύση δεν περιγράφονται ως πόσιμες χωρίς ρητή δήλωση.
Παράδειγμα
Ο τύπος εξοπλισμού και τα χαρακτηριστικά πρέπει να ξεχωρίζουν.
Ο
Όριο ρυθμού – rate limit
Περιορισμός ρυθμού αιτήσεων προς υπηρεσία. Κανόνες και οδηγίες επανάληψης εξαρτώνται από ενεργή σύμβαση.
Παράδειγμα
Κωδικός 429 ζητά τήρηση οδηγιών επανάληψης.
Π
Παραλαβή οχήματος
Η ενέργεια έναρξης χρήσης ενός οχήματος. Ένας θετικός μετρητής δεν αρκεί αν η υπηρεσία υποδεικνύει απενεργοποίηση παραλαβής.
Παράδειγμα
Υπάρχουν ποδήλατα αλλά ο σταθμός μπορεί να μην επιτρέπει την ενοικίαση.
Παράμετρος ερωτήματος
Τιμή που αποστέλλεται ως μέρος της διεύθυνσης URL μετά το ερωτηματικό. Όνομα και μορφή ορίζονται από τη διεπαφή.
Παράδειγμα
modes=bus,tram επιλέγει μέσα σε συμβατό URL.
Παραπληροφόρηση βοηθού ΤΝ
Παραγωγή μη τεκμηριωμένης πληροφορίας σαν να είναι γνωστή. Στην κινητικότητα μπορεί να είναι εφευρημένα ωράρια ή διαθεσιμότητες.
Παράδειγμα
Ο βοηθός ανακοινώνει διέλευση ενώ το εργαλείο επέστρεψε μόνο στάση.
Παρατήρηση
Καταγεγραμμένη κατάσταση ή γεγονός σε συγκεκριμένη στιγμή. Πρέπει να διαχωρίζεται από προγραμματισμένο ή εκτιμώμενο συμβάν.
Παράδειγμα
Η πραγματική διέλευση λεωφορείου μπορεί να διαφέρει από την εκτίμηση.
Πελάτης MCP
Στοιχείο της εφαρμογής ΤΝ που επικοινωνεί με διακομιστή MCP. Διαχειρίζεται ανταλλαγές πρωτοκόλλου για αυτή τη σύνδεση.
Παράδειγμα
Ο πελάτης στέλνει παραμέτρους αναζήτησης στο ROOTE.
Πλευρά
Χώρος ή σημείο επιβίβασης σε μεταφορικό μέσο. Πολλές πλευρές σε κοντινή απόσταση μπορεί να εξυπηρετούν διαφορετικές κατευθύνσεις ή υπηρεσίες.
Παράδειγμα
Οι δύο κατευθύνσεις μιας γραμμής μπορεί να χρησιμοποιούν ξεχωριστές πλευρές.
Προγραμματισμένη ώρα
Προγραμματισμένη ώρα στο πρόγραμμα για συγκεκριμένη ημερομηνία και δρομολόγιο. Δεν περιγράφει απαραίτητα την τρέχουσα θέση ή κατάσταση οχήματος.
Παράδειγμα
Αφετηρία έχει προγραμματιστεί για τις 8:10 στο ημερολόγιο.
Προέλευση
Πληροφορίες που επιτρέπουν τον εντοπισμό πηγής δεδομένων και, κατά σύμβαση, τον τρόπο παραγωγής. Βοηθούν την ερμηνεία της έκτασης.
Παράδειγμα
Ένα αποτέλεσμα διατηρεί πηγή και πλαίσιο συλλογής.
Προσανατολισμός
Ενδειξη κατεύθυνσης ή προορισμού υπηρεσίας. Πρέπει να ελεγχθεί μαζί με το δρομολόγιο και το σημείο επιβίβασης.
Παράδειγμα
Ψάχνετε το τραμ προς τον προορισμό σας, όχι προς την αντίθετη κατεύθυνση.
Προσβασιμότητα
Χαρακτηριστικά που επιτρέπουν τη χρήση χώρου ή υπηρεσίας σύμφωνα με τις ανάγκες του χρήστη. Η άγνωστη πληροφορία δεν σημαίνει ούτε προσβάσιμο ούτε μη προσβάσιμο.
Παράδειγμα
Η προσβασιμότητα με αναπηρικό αμαξίδιο μπορεί να είναι γνωστή ή άγνωστη.
Σ
Σημείο εκκίνησης αναζήτησης
Σημείο από το οποίο γίνεται αναζήτηση διερχόμενων αντικειμένων και υπολογίζονται αποστάσεις. Μπορεί να διαφέρει από το κέντρο της εμφάνισης χάρτη.
Παράδειγμα
Η κάμερα κινείται ενώ η αναζήτηση παραμένει κεντραρισμένη στη Μπορντό.
Σημείο ενδιαφέροντος – POI
Αναγνωρίσιμη τοποθεσία χρήσιμη για αναζήτηση, όπως ίδρυμα ή εξοπλισμός. Ένα POI διαφέρει από απλή ταχυδρομική διεύθυνση.
Παράδειγμα
Το όνομα ξενοδοχείου μπορεί να αναζητηθεί ως ίδρυμα.
Σταθμός ποδηλάτων
Οργανωμένος χώρος για παραλαβή ή επιστροφή κοινόχρηστων ποδηλάτων. Οι συντεταγμένες, η χωρητικότητα και η διαθεσιμότητα περιγράφουν διαφορετικές πλευρές του σταθμού.
Παράδειγμα
Ένας σταθμός μπορεί να εμφανίζεται στον χάρτη και να είναι προσωρινά άδειος.
Σταθμός φόρτισης
Εξοπλισμός που επιτρέπει τη φόρτιση συμβατού οχήματος. Η ανεύρεση σταθμού δεν εγγυάται τη διαθεσιμότητα ή συμβατότητα σύνδεσης.
Παράδειγμα
Η θέση φόρτισης και η κατάσταση χρήσης της είναι δύο διακριτές πληροφορίες.
Στάση μεταφοράς
Τόπος όπου μία υπηρεσία μεταφοράς επιβιβάζει ή αποβιβάζει επιβάτες. Μια στάση χωρίς στέγαστρο δεν αναφέρει αυτόματα τα επόμενα δρομολόγια.
Παράδειγμα
Μια στάση λεωφορείου που επιστρέφεται χωρίς προγραμματισμένη ώρα αναχώρησης.
Συντεταγμένες GPS
Τιμές που αναπαριστούν σημείο στον χάρτη, συνήθως γεωγραφικό πλάτος και μήκος. Η σειρά πρέπει να διευκρινίζεται στη χρησιμοποιούμενη διεπαφή.
Παράδειγμα
Ερώτηση εγγύτητας δέχεται δύο διακριτές συντεταγμένες.
Τ
Τερματικός σταθμός
Τέλος διαδρομής μεταφορικού μέσου. Μια γραμμή μπορεί να έχει παραλλαγές με διαφορετικούς τερματικούς σταθμούς.
Παράδειγμα
Μια σύντομη υπηρεσία τελειώνει πριν τον συνήθη τερματικό σταθμό.
Τύπος υπηρεσίας
Κατηγορία που χρησιμοποιείται για επιλογή ή περιγραφή αστικής υπηρεσίας. Οι αποδεκτές τιμές εξαρτώνται από τη διεπαφή και το σχήμα της.
Παράδειγμα
Το API Υπηρεσιών ROOTE χρησιμοποιεί types=toilets για τουαλέτες.
Φ
Φρεσκάδα δεδομένων
Εκτίμηση επικαιρότητας πληροφορίας βάσει ημερομηνιών και κανόνων πιστοποίησης. Το χρόνο προβολής δεν αρκεί για απόδειξη φρεσκάδας πηγής.
Παράδειγμα
Μετρητής ληφθείς τώρα μπορεί να προέρχεται από παλαιότερη παρατήρηση.
Χ
Χρονική σήμανση
Χρονική ένδειξη συνδεδεμένη με δεδομένο ή γεγονός. Το νόημα εξαρτάται από το πεδίο: παρατήρηση, ενημέρωση, λήψη ή λήξη.
Παράδειγμα
source_updated_at και received_at περιγράφουν διαφορετικό στάδιο.
Χρονικό όριο – timeout
Διακοπή αναμονής που υπερβαίνει καθορισμένη διάρκεια λειτουργίας. Σημαίνει μη ολοκληρωμένη αναζήτηση, όχι απουσία αποτελεσμάτων.
Παράδειγμα
Εφαρμογή προτείνει επανάληψη αντί κενής λίστας.
Χωρίς σταθμό – free-floating
Οργάνωση όπου τα οχήματα δεν απαιτείται να λαμβάνονται ή να επιστρέφονται σε σταθερή θέση. Οι ζώνες και κανόνες στάθμευσης παραμένουν αυτοί της υπηρεσίας.
Παράδειγμα
Ένα πατίνι πρέπει να επιστραφεί σε επιτρεπτή ζώνη.
Ω
Ώρες λειτουργίας
Χρονικά διαστήματα κατά τα οποία ένας χώρος δηλώνει ότι είναι ανοικτός. Δεν επιβεβαιώνουν άμεση λειτουργία σε πραγματικό χρόνο.
Παράδειγμα
Μια προσωρινή διακοπή μπορεί να μην εμφανίζεται στα συνήθη ωράρια.
A
API
Διεπαφή που επιτρέπει σε πρόγραμμα να χρησιμοποιεί δυνατότητες άλλης υπηρεσίας μέσω ορισμένης σύμβασης. Περιγράφει εισόδους και αναμενόμενες απαντήσεις.
Παράδειγμα
Εφαρμογή αναζητά στάσεις με API ROOTE.
API REST
Προσέγγιση HTTP διεπαφής με χρήση πόρων και μηχανισμών web. Η συμφωνία API περιγράφει διαδρομές, μεθόδους και αναπαραστάσεις.
Παράδειγμα
Αναζήτηση στέλνεται σε τεκμηριωμένη GET διαδρομή.
C
Cache
Προσωρινή αποθήκευση αποτελεσμάτων για αποφυγή επαναλαμβανόμενων ίδιων αναζητήσεων. Μια cached τιμή διατηρεί πηγή και χρονικό πλαίσιο.
Παράδειγμα
Δύο ίδιες αιτήσεις μπορεί να επαναχρησιμοποιήσουν έγκυρη απάντηση.
E
Embed – ενσωματωμένος χάρτης
Εισαγωγή εξωτερικής εμπειρίας σε σελίδα, π.χ. ενσωμάτωση χάρτη σε iframe. Παράμετροι και δικαιώματα καθορίζουν το περιβάλλον χρήσης.
Παράδειγμα
Iframe ROOTE εμφανίζει ποδήλατα γύρω από τη Μπορντό.
Endpoint – διαδρομή API
Διεύθυνση και ενέργεια που προσφέρει API για δοσμένη ικανότητα. Διάφορες διαδρομές μπορεί να επιστρέφουν διαφορετικές οικογένειες αποτελεσμάτων.
Παράδειγμα
/v1/transit/nearby αναζητεί κοντινά σημεία μεταφοράς.
G
GBFS
Τυποποιημένη μορφή δημόσιων δεδομένων κοινόχρηστης κινητικότητας. Ανάλογα με έκδοση και ροές περιγράφει συστήματα, σταθμούς, οχήματα και καταστάσεις τους.
Παράδειγμα
Οι πληροφορίες σταθμού και οι μετρητές διαθεσιμότητας είναι ξεχωριστά.
GTFS Realtime – GTFS-RT
Τυποποιημένη μορφή για μετάδοση ενημερώσεων δρομολογίων, θέσεων οχημάτων και ειδοποιήσεων. Οι κατηγορίες που δημοσιεύονται εξαρτώνται από τον παραγωγό.
Παράδειγμα
Ροή θέσεων δεν συνεπάγεται εκτιμήσεις για όλες τις στάσεις.
GTFS Schedule
Τυποποιημένη μορφή περιγραφής προγραμματισμένων υπηρεσιών μεταφοράς: στάσεις, γραμμές, δρομολόγια, ημερολόγια και συνέπειες. Δεν παρέχει αυτόματα ενημερώσεις σε πραγματικό χρόνο.
Παράδειγμα
Τα προγραμματισμένα δρομολόγια συνδέονται με γραμμές και ημέρες υπηρεσίας.
I
Iframe
HTML στοιχείο που φορτώνει Έγγραφο σε σελίδα. Σε διαφορετικά domains, η γονική σελίδα δεν μπορεί να διαβάζει κατάσταση εγγενούς εγγράφου ελεύθερα.
Παράδειγμα
Αλλαγές αναζήτησης απαιτούν τεκμηριωμένη επικοινωνία με τη γονική σελίδα.
J
JSON
Δομημένη μορφή κειμένου με αντικείμενα, πίνακες, αλφαριθμητικά και αριθμούς. Έγκυρο JSON μπορεί να μη συμφωνεί με σχήμα API.
Παράδειγμα
Συλλογή stations πρέπει να έχει αναμενόμενο τύπο και πεδία.
M
MCP – Model Context Protocol
Πρωτόκολλο για επικοινωνία εφαρμογής ΤΝ με διακομιστές που παρέχουν εργαλεία ή περιβάλλον. Δεν καθορίζει αυτόματα ποιότητα δεδομένων.
Παράδειγμα
Βοηθός ανακαλύπτει εργαλεία αναζήτησης ROOTE.
O
OpenAPI
Προδιαγραφή που περιγράφει σύμβαση HTTP API σε δομημένο έγγραφο. Βοηθά στην επαλήθευση διαδρομών, παραμέτρων, απαντήσεων και σχημάτων.
Παράδειγμα
Η σύμβαση ROOTE δημοσιεύεται σε openapi.json.
S
Streamable HTTP
Μέσο επικοινωνίας MCP με εξωτερικό διακομιστή μέσω HTTP. Η υποστήριξη πρέπει να ελέγχεται στον πελάτη.
Παράδειγμα
Ο εξωτερικός διακομιστής ROOTE χρησιμοποιεί https://mcp.roote.ai/mcp.
Δεν ταιριάζει κανένας ορισμός. Δοκιμάστε άλλη λέξη ή αφαιρέστε φίλτρο.
Αναφορές για εμβάθυνση
Οι όροι ειδικοί του ROOTE ακολουθούν τις τεκμηριωμένες συμφωνίες του. Τα πρότυπα και πρωτόκολλα έχουν τις δικές τους επίσημες αναφορές.
Επιστροφή στο κέντρο πόρων