نوٹ:

جب آپ چاہتے ہوں کہ صارفین Scribble Maps میں سائن ان کریں، اپنے دستیاب نقشے براؤز کریں، اور نقشے کا ڈیٹا براہِ راست آپ کی ویب ایپلیکیشن کو واپس بھیجیں تو ScribbleMaps Connect Picker استعمال کریں۔

 

پکر ایک پاپ اپ میں کھلتا ہے اور صارف کے سائن ان کا عمل وہیں سنبھالتا ہے، اس لیے آپ کی ایپلیکیشن کو 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. اپنے ویب صفحے میں 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، اور ایک 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