Бележка:

Използвайте 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. В своята уеб страница добавете 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. В 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