Σημείωση:

Χρησιμοποιήστε το ScribbleMaps Connect Picker όταν θέλετε οι χρήστες να συνδέονται στο Scribble Maps, να περιηγούνται στους διαθέσιμους χάρτες τους και να επιστρέφουν δεδομένα χαρτών απευθείας στην εφαρμογή ιστού σας.

 

Το picker ανοίγει σε ένα αναδυόμενο παράθυρο και χειρίζεται τη διαδικασία σύνδεσης του χρήστη εκεί, επομένως η εφαρμογή σας δεν χρειάζεται να συλλέγει απευθείας διαπιστευτήρια Scribble Maps.

Περιεχόμενα

Πώς λειτουργεί το Connect Picker

Το ScribbleMaps Connect Picker επιτρέπει στους χρήστες σας να περιηγούνται, να αναζητούν και να επιλέγουν χάρτες από το Scribble Maps, και στη συνέχεια να επιστρέφουν αυτά τα δεδομένα χάρτη απευθείας στην εφαρμογή σας στη μορφή που επιλέγετε.

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

Περίπτωση Χρήσης / Παράδειγμα:

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

Προβολή Περιεχομένων ↑

Λάβετε το Client ID σας

1. Ανοίξτε τον ιστότοπο προγραμματιστών του Scribble Maps:
   https://developers.scribblemaps.com

    

2. Καταχωρίστε ένα δωρεάν έργο (free project).

    

3. Αντιγράψτε το Client ID σας.

   Θα χρησιμοποιήσετε αυτήν την τιμή κατά την κλήση του Connect Picker.

Προβολή Περιεχομένων ↑

Προσθέστε το SDK στη σελίδα σας

1. Στην ιστοσελίδα σας, προσθέστε το Connect Picker SDK:

   <script src="https://api.scribblemaps.com/connect/picker.js"></script>

    

2. Αποθηκεύστε τις αλλαγές της σελίδας σας.

   Το Scribble Maps Connect Picker είναι πλέον διαθέσιμο στην εφαρμογή σας.

Προβολή Περιεχομένων ↑

Ανοίξτε το Connect Picker

1. Καλέστε το ScribbleMapsConnect.pick() από τη σελίδα σας.

    

2. Περάστε το clientId σας, τη μορφή εξαγωγής (export format) που επιθυμείτε και μια επανάκληση onSelect.

    

3. Χρησιμοποιήστε κώδικα παρόμοιο με το ακόλουθο παράδειγμα:

   ScribbleMapsConnect.pick({
     clientId: 'YOUR_CLIENT_ID',
     format: 'geojson',
     onSelect: function (result) {
       // result.data contains your GeoJSON
       // result.title, result.mapCode, result.thumbUrl also available
       loadIntoMyApp(result.data);
     }
   });

   Όταν ανοίγει το picker, ο χρήστης μπορεί να ταυτοποιηθεί, να περιηγηθεί στους διαθέσιμους χάρτες του και να επιλέξει έναν.

Προβολή Περιεχομένων ↑

Χειριστείτε τα επιλεγμένα δεδομένα χάρτη

1. Στην επανάκληση onSelect, αποκτήστε πρόσβαση στο result.data.

   Αυτό περιέχει τα δεδομένα χάρτη στη μορφή που ζητήσατε.
    

2. (Προαιρετικά) Χρησιμοποιήστε τα πρόσθετα πεδία που επιστρέφονται:

   • result.title — ο τίτλος του χάρτη
   • result.mapCode — ο κωδικός χάρτη Scribble Maps
   • result.thumbUrl — μια διεύθυνση URL μικρογραφίας (thumbnail URL) για τον χάρτη
    

3. Περάστε τα δεδομένα στη λογική της εφαρμογής σας.

   Για παράδειγμα, φορτώστε το επιστρεφόμενο GeoJSON στο δικό σας πρόγραμμα προβολής χαρτών ή στη ροή εργασίας δεδομένων σας.

Προβολή Περιεχομένων ↑

Προαιρετική διαμόρφωση

Μπορείτε να διαμορφώσετε το picker ώστε να ταιριάζει καλύτερα στη ροή εργασίας της εφαρμογής σας.

1. Επιλέξτε τη μορφή εξαγωγής αλλάζοντας την τιμή format.

   Για παράδειγμα: geojson, kml, csv, gpx, dxf, shapefile, ή smjson.
    

2. Επιλέξτε ποιες πηγές χαρτών μπορούν να περιηγηθούν οι χρήστες με την επιλογή tabs.

   Οι χρήστες μπορούν να περιηγηθούν σε χάρτες από την προσωπική τους βιβλιοθήκη (personal library), τους κοινόχρηστους χάρτες της ομάδας (team-shared maps) ή τη συλλογή της κοινότητας (community collection).
    
3. (Προαιρετικά) Χρησιμοποιήστε τα περιλαμβανόμενα στυλ κουμπιών για να ταιριάζουν με μια light ή dark διεπαφή.

Προβολή Περιεχομένων ↑

Υποστηριζόμενες μορφές και επιστρεφόμενα πεδία

Υποστηριζόμενες μορφές εξαγωγής:

• GeoJSON
• KML
• CSV
• GPX
• DXF
• Shapefile
• SMJSON

Επιστρεφόμενα πεδία αποτελεσμάτων:

• data
• title
• mapCode
• thumbUrl

Μόλις διαμορφωθεί, το Connect Picker δίνει στους χρήστες σας πρόσβαση στα δεδομένα τους στο Scribble Maps απευθείας μέσα από την εφαρμογή σας μέσω ενός ενιαίου σημείου ενσωμάτωσης.

Σχετικά

Scribble Maps Developers

Scribble Maps Connect Picker

Εισαγωγή/Εξαγωγή Αρχείων & Δεδομένων - GeoJSON, εικόνες, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, κ.λπ.

Εισαγωγή/Εξαγωγή: Περιγραφές, Παραδείγματα, Περιορισμοί και Εναλλακτικές Λύσεις - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP