Нататка:

Выкарыстоўвайце 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. Захавайце змяненні на старонцы.

   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. (Неабавязкова) Выкарыстайце ўключаныя стылі кнопак, каб яны адпавядалі светламу або цёмнаму інтэрфейсу.

Выгляд Змест ↑

Падтрымліваныя фарматы і вернутыя палі

Падтрымліваныя фарматы экспарту:

• 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