הערה:

השתמש/י ב-ScribbleMaps Connect Picker כאשר ברצונך שמשתמשים יתחברו ל-Scribble Maps, יעיינו במפות הזמינות להם ויחזירו נתוני מפה ישירות לאפליקציית האינטרנט שלך.

 

הבורר נפתח בחלון קופץ ומטפל שם בתהליך ההתחברות של המשתמש, כך שהאפליקציה שלך אינה צריכה לאסוף ישירות פרטי התחברות של Scribble Maps.

תוכן עניינים

איך Connect Picker עובד

ScribbleMaps Connect Picker מאפשר למשתמשים שלך לעיין במפות מ-Scribble Maps, לחפש אותן ולבחור אותן, ואז להחזיר את נתוני המפה ישירות לאפליקציה שלך בפורמט שתבחר/י.

זה שימושי כאשר ברצונך שמשתמשים ייצרו וינהלו נתונים גיאוגרפיים ב-Scribble Maps ואז יטענו את הנתונים האלה לאפליקציה שלך, בלי שתצטרך/י לבנות דפדפן מפות או תהליך התחברות משלך.

מקרה שימוש / דוגמה:

שילוב זה שימושי עבור לוחות מחוונים, כלים לנכסים, אפליקציות לנתוני שטח ואפליקציות אינטרנט אחרות הזקוקות לכך שמשתמשים יבחרו ויטענו נתונים ממופים מ-Scribble Maps.

חזרה לתוכן העניינים ↑

קבלת ה-Client ID שלך

1. פתח/י את אתר המפתחים של Scribble Maps:
   https://developers.scribblemaps.com

    

2. הרשמה של פרויקט חינמי.

    

3. העתק/י את ה-Client ID שלך.

   תשתמש/י בערך זה בעת קריאה ל-Connect Picker.

חזרה לתוכן העניינים ↑

הוספת ה-SDK לדף שלך

1. בדף האינטרנט שלך, הוסף/י את ה-SDK של Connect Picker:

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

    

2. שמור/י את השינויים בדף שלך.

   ScribbleMaps Connect Picker זמין כעת לאפליקציה שלך.

חזרה לתוכן העניינים ↑

פתיחת Connect Picker

1. קרא/י ל-ScribbleMapsConnect.pick() מהדף שלך.

    

2. העבר/י את ה-clientId שלך, את format הייצוא הרצוי ואת פונקציית ה-callback 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);
     }
   });

   כאשר הבורר נפתח, המשתמש יכול להתחבר, לעיין במפות הזמינות לו ולבחור אחת מהן.

חזרה לתוכן העניינים ↑

טיפול בנתוני המפה שנבחרה

1. בתוך ה-callback onSelect, גש/י ל-result.data.

   זה מכיל את נתוני המפה בפורמט שביקשת.
    

2. (אופציונלי) השתמש/י בשדות המוחזרים הנוספים:

   • result.title — כותרת המפה
   • result.mapCode — קוד המפה ב-Scribble Maps
   • result.thumbUrl — כתובת URL של תמונה ממוזערת של המפה
    

3. העבר/י את הנתונים ללוגיקה של האפליקציה שלך.

   לדוגמה, טען/י את ה-GeoJSON שהוחזר לצופה המפות או לתהליך העבודה עם הנתונים שלך.

חזרה לתוכן העניינים ↑

הגדרות אופציונליות

אפשר להגדיר את הבורר כך שיתאים טוב יותר לתהליך העבודה של האפליקציה שלך.

1. בחירת פורמט הייצוא על ידי שינוי הערך של format.

   לדוגמה: geojson, kml, csv, gpx, dxf, shapefile או smjson.
    

2. בחירת מקורות המפות שהמשתמשים יכולים לעיין בהם באמצעות האפשרות tabs.

   משתמשים יכולים לעיין במפות מהספרייה האישית שלהם, ממפות משותפות של הצוות או מאוסף הקהילה.
    
3. (אופציונלי) השתמש/י בסגנונות הכפתורים הכלולים כדי להתאים לממשק בהיר או כהה.

חזרה לתוכן העניינים ↑

פורמטים נתמכים ושדות מוחזרים

פורמטי ייצוא נתמכים:

• 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