ملاحظة:

استخدم ScribbleMaps Connect Picker عندما تريد أن يقوم المستخدمون بتسجيل الدخول إلى Scribble Maps، وتصفح خرائطهم المتاحة، وإرجاع بيانات الخريطة مباشرة إلى تطبيق الويب الخاص بك.

 

يفتح المنتقي في نافذة منبثقة ويتعامل مع عملية تسجيل دخول المستخدم هناك، لذلك لا يحتاج تطبيقك إلى جمع بيانات اعتماد Scribble Maps مباشرة.

المحتويات

كيفية عمل Connect Picker

يتيح ScribbleMaps Connect Picker لمستخدميك تصفح الخرائط والبحث عنها وتحديدها من Scribble Maps، ثم إرجاع بيانات الخريطة تلك مباشرة إلى تطبيقك بالتنسيق الذي تختاره.

هذا مفيد عندما تريد أن يقوم المستخدمون بإنشاء أو إدارة البيانات الجغرافية في Scribble Maps ثم تحميل تلك البيانات في تطبيقك الخاص دون بناء متصفح خرائط خاص بك أو تدفق تسجيل الدخول.

حالة الاستخدام / مثال:

هذا التكامل مفيد للوحات المعلومات (dashboards)، وأدوات العقارات، وتطبيقات البيانات الميدانية، وتطبيقات الويب الأخرى التي تحتاج إلى قيام المستخدمين بتحديد وتحميل البيانات المرسومة على الخرائط من Scribble Maps.

عرض المحتويات ↑

الحصول على Client ID الخاص بك

1. افتح موقع مطوري Scribble Maps:
   https://developers.scribblemaps.com

    

2. قم بتسجيل مشروع مجاني.

    

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 الخاص بك، و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. في استدعاء الارتجاع 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. (اختياري) استخدم أنماط الأزرار المضمنة لتتناسب مع واجهة 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