یادداشت:

وقتی می‌خواهید کاربران وارد 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. در صفحه وب خود، SDK مربوط به Connect Picker را اضافه کنید:

   <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. در callback به نام onSelect، به result.data دسترسی پیدا کنید.

   این مقدار شامل داده‌های نقشه در قالبی است که درخواست کرده‌اید.
    

2. (اختیاری) از فیلدهای برگردانده‌شده اضافی استفاده کنید:

   • result.title — عنوان نقشه
   • result.mapCode — کد نقشه Scribble Maps
   • result.thumbUrl — نشانی تصویر بندانگشتی نقشه
    

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