Terra GIS-API

Εάν θέλετε να εμπλουτίσετε τις web & mobile εφαρμογές σας με γεωγραφική πληροφορία από απλή απεικόνιση έως σύνθετη χωρική ανάλυση χρησιμοποιήστε την GIS εργαλειοθήκη της Terra που προσφέρεται ως GIS API. Το Terra GIS-API σας δίνει την δυνατότητα ανεξαρτήτως γλώσσας προγραμματισμού (εφόσον υποστηρίζονται HTTP requests) και περιβάλλοντος ανάπτυξης να “καταναλώσετε” άμεσα στην εφαρμογή σας την επιθυμητή υπηρεσία γεωεπεξεργασίας καλώντας την μέσω του αντίστοιχου URL.

Έτοιμες-προς-Χρήση Υπηρεσίες του Terra GISAPI

Το Terra GIS-API προσφέρει τις παρακάτω υπηρεσίες γεωεπεξεργασίας (για αναλυτική περιγραφή της κάθε υπηρεσίας πλοηγηθείτε στο Υπηρεσίες Γεωεπεξεργασίας):

  1. Χαρτογραφικά Υπόβαθρα: χρησιμοποιείστε την Map υπηρεσία του API για να εμφανίσετε άμεσα στην εφαρμογή σας το λεπτομερές χαρτογραφικό υπόβαθρο της Terra (δείτε την γεωγραφική μας βάση στο χαρτογραφικό portal της Terra)
  2. Γεωκωδικοποίηση και Αναζήτηση Σημείων Ενδιαφέροντος (POI): συμπληρώστε σε ελεύθερο κείμενο λεκτικά διεύθυνσης ή σημείων ενδιαφέροντος και ανακαλύψτε την θέση τους στον χάρτη. Χρησιμοποιείστε την λειτουργία της Αντίστροφης Γεωκωδικοποίησης (Reverse Geocoding) και βρείτε την διεύθυνση που αντιστοιχεί σε συγκεκριμένες γεωγραφικές συντεταγμένες. Γεωκωδικοποιήστε μαζικά ένα πλήθος διευθύνσεων
  3. Δρομολόγηση: βρείτε την βέλτιστη διαδρομή (χρόνος, απόσταση) μεταξύ δύο ή περισσοτέρων σημείων με συνδυασμό παραμέτρων (διατήρηση πρώτου και τελευταίου σημείου, αποφυγή διοδίων, πεζός ή χρήση αυτοκινήτου)
  4. Μέσα Μαζικής Μεταφοράς (ΝΕΟ): χρησιμοποιήστε συνδυασμό μέσω μαζικής μεταφοράς (συμπεριλαμβανομένων ακτοπλοϊκών συγκοινωνιών) για να φτάσετε στον προορισμό σας
  5. Περιοχές Κάλυψης (Service Areas): οριοθετήστε την περιοχή εξυπηρέτησης των καταστημάτων σας δημιουργώντας πολύγωνα γεωγραφικών περιοχών με βάση την χρονική ή χιλιομετρική απόσταση από το σημείο του / των καταστημάτων
  6. Vehicle Routing Problem: βρείτε την βέλτιστη διαδρομή (ελαχιστοποίηση κόστους) μεταξύ των σημείων παραλαβής και σημείων παράδοσης του στόλου των οχημάτων σας βάση ενός πλήθους παραμέτρων που περιλαμβάνουν τα χαρακτηριστικά του στόλου (οχήματα: πλήθος, χωρητικότητα, μέγιστη επιτρεπόμενη ταχύτητα, είδος καυσίμου, κόστος λειτουργίας, οδηγοί: αριθμός, διαθεσιμότητα, ικανότητα, κόστος, κόστος υπερωριών, οφέλιμος χρόνος οδήγησης), τις παραγγελίες (πλήθος, ποσότητες παράδοσης / παραλαβής για κάθε όχημα και σημείο, χρόνος παράδοσης), τις αποθήκες (πλήθος, χωρητικότητα, είδος εμπορεύματος, ώρες λειτουργίας) και το οδικό δίκτυο (κατηγορίες οδών, ταχύτητες, κατευθύνσεις, αναστροφές)

Χρήση του Terra GISAPI

Η Terra για την υλοποίηση του API χρησιμοποιεί αφενός την πλατφόρμα ArcGIS (του οίκου ESRI) για να αναπτύξει τις υπηρεσίες του API ως web services και αφετέρου την γεωγραφική βάση της εταιρείας μας για να επιστρέψει τα αποτελέσματα της κάθε υπηρεσίας. Ο συνδυασμός αυτός επιτρέπει τόσο την αξιοποίηση του API σε μία πληθώρα συσκευών και προγραμματιστικών δομών (frameworks) όσο και την παραγωγή αξιόπιστων αποτελεσμάτων δεδομένης της ακρίβειας και πληρότητας της γεωγραφικής βάσης της Terra.

Για να χρησιμοποιήσετε επιτυχώς το Terra GIS-API πρέπει να κατανοήσετε πώς να κατασκευάσετε το URL της κάθε υπηρεσίας και πώς να ερμηνεύσετε την απάντηση.

Το συντακτικό του URL είναι το εξής:

http:///?<?<parameter1=value1>&<parameter2=value2>

όπου:

  • http://: είναι URL του συγκεκριμένου πόρου που θα χρησιμοποιηθεί
  • : αναπαριστά την ονομασία της υποστηριζόμενης υπηρεσίας του αντίστοιχου πόρου
  • ?: δηλώνει την έναρξη της λίστας των παραμέτρων
  • Η πρώτη παράμετρος με την ονομασία custGuid, είναι το κλειδί πρόσβασης (token) που σας παρέχει η Terra για την ενεργοποίηση και του χρόνου διάρκειας (ή των μονάδων κατανάλωσης) της υπηρεσίας
  • Οι υπόλοιπες παράμετροι αναφέρονται σε συγκεκριμένη υπηρεσία

Εάν για παράδειγμα θέλετε να μετατρέψετε την διεύθυνση της εταιρείας μας (ή πιο συγκεκριμένα το λεκτικό της διεύθυνσης) σε γεωγραφικές συντεταγμένες τότε θα χρειαστεί να χρησιμοποιήσετε την λειτουργία γεωεπεξεργασίας “Geocoding” του Terra GIS-API η οποία προσφέρεται, σύμφωνα με τα παραπάνω από το ακόλουθο URL:

http: :///Geocoding?custGuid=901059c4-51d2-4e4c-b065-f41cb14eec7c&?countryCode=30&input=Αριστοτέλους 6, Χολαργός&SRID=4326

όπου:

  • http://: είναι URL του συγκεκριμένου πόρου
  • δηλώνει ότι θα γίνει χρήση της υπηρεσίας γεωκωδικοποίησης του Terra GIS-API
  • <custGuid=901059c4-51d2-4e4c-b065-f41cb14eec7c> είναι το token χρήσης της υπηρεσίας, και ακολουθεί η λίστα τριών παραμέτρων countryCode=30 για Ελλάδα, input=Αριστοτέλους 6, Χολαργός η διεύθυνση αναζήτησης και SRID=4326 το προβολικό σύστημα των συντεταγμένων (το 4326 αναφέρεται στο WGS84)

Το παραπάνω URL θα επιστρέψει το ακόλουθο αποτέλεσμα σε μορφή JSON:

{“matchType”:”10″,”addressItems”:[{“address”:”Aristotelous 6, Cholargos, Attikis 15562″,”location”:{“x”:23.804138135682276,”y”:38.007713177420307},”score”:100,”absScore”:”1.6″,”attributes”:{“street”:”Aristotelous”,”num”:”6″,”zip”:”15562″,”municip”:”Cholargos”,”pref”:”Attikis”,”country”:”Grèce”,”addType”:”1″},”LangCode”:”GRX”}]}

Μπορείτε να εξερυνήσετε τις υπηρεσίες του Terra GIS-API κατευθείαν από το Services Directory. Σε συνέχεια του παραπάνω παραδείγματος μπορείτε να αναζητήσετε οποιαδήποτε διεύθυνση μέσω γραφικού περιβάλλοντος πληκτρολογώντας το URL: http://mapsrv5.terra.gr/avl/webservice.asmx?op=getAddressJSON στον web browser.

Θα δείτε την παρακάτω εικόνα:

Όπου στην λίστα των παραμέτρων συμπληρώστε countryCode: 30, input: την διεύθυνση που αναζητάτε και SRID: 4326 για επιστροφή συντεταγμένων στο WGS84 ή 2100 για επιστροφή συντεταγμένων στο ΕΓΣΑ87 και πατήστε INVOKE για να δείτε τα αποτελέσματα σε μορφή JSON σε νέα σελίδα.

Terra GISAPI Responses

Το Terra GIS-API είναι υλοποιημένο ως REST API και παράγει αποτελέσματα μορφής κυρίως JSON. Υποστηρίζει παράλληλα τις παρακάτω μορφές: HTML, JSON, IMAGE (επιστρέφει μία εικόνα συνεχούς ροής) και KMZ (επιστρέφει ένα KML αρχείο σε KMZ μορφή).

Η τεκμηρίωση του Terra GIS-API

Η Terra θα σας προσφέρει μία πλήρη τεκμηρίωση του Terra GIS-API κατά την παροχή της υπηρεσίας.

Ένα παράδειγμα χρήσης του Terra GISAPIμπορείτε να δείτε στην σελίδα Πελάτες > Χρυσός Οδηγός.