Nota:

Uża l-ScribbleMaps Connect Picker meta tkun trid li l-utenti jidħlu f'Scribble Maps, ifittxu l-mappi disponibbli tagħhom, u jirritornaw id-data tal-mappa direttament lill-applikazzjoni web tiegħek.

 

Il-picker jinfetaħ f'popup u jimmaniġġja hemmhekk il-proċess ta' sign-in tal-utent, hekk li l-applikazzjoni tiegħek ma jkollhiex bżonn tiġbor direttament il-kredenzjali ta' Scribble Maps.

Werrej

Kif jaħdem il-Connect Picker

L-ScribbleMaps Connect Picker jippermetti lill-utenti tiegħek ifittxu, jfittxu b'tfittxija, u jagħżlu mappi minn Scribble Maps, imbagħad jirritorna d-data ta' dik il-mappa direttament lill-applikazzjoni tiegħek fil-format li tagħżel.

Dan huwa utli meta trid li l-utenti joħolqu jew jimmaniġġjaw il-geodata f'Scribble Maps u mbagħad iṫaqqlu dik id-data fl-app tiegħek stess mingħajr ma tibni browser tal-mappi jew fluss ta' sign-in tiegħek.

Każ ta' Użu / Eżempju:

Din l-integrazzjoni hija utli għal dashboards, għodod tal-proprjetà, applikazzjonijiet ta' data tal-field, u web apps oħra li għandhom bżonn li l-utenti jagħżlu u jtaqqlu data mmappjata minn Scribble Maps.

Ara l-Werrej ↑

Ikseb il-Client ID tiegħek

1. Iftaħ is-sit tal-iżviluppaturi ta' Scribble Maps:
   https://developers.scribblemaps.com

    

2. Irreġistra proġett b'xejn.

    

3. Ikkopja l-Client ID tiegħek.

   Se tuża dan il-valur meta ssejjaħ il-Connect Picker.

Ara l-Werrej ↑

Żid l-SDK mal-paġna tiegħek

1. Fil-paġna web tiegħek, żid l-SDK tal-Connect Picker:

   <script src="https://api.scribblemaps.com/connect/picker.js"></script>

    

2. Salva l-bidliet tal-paġna tiegħek.

   L-ScribbleMaps Connect Picker issa huwa disponibbli għall-applikazzjoni tiegħek.

Ara l-Werrej ↑

Iftaħ il-Connect Picker

1. Sejjaħ ScribbleMapsConnect.pick() mill-paġna tiegħek.

    

2. Għaddi l-clientId tiegħek, il-format tal-esportazzjoni li tixtieq, u callback onSelect.

    

3. Uża kodiċi simili għall-eżempju li ġej:

   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);
     }
   });

   Meta jinfetaħ il-picker, l-utent jista' jawtentika ruħu, ifittex il-mappi disponibbli tiegħu, u jagħżel waħda.

Ara l-Werrej ↑

Immaniġġja d-data tal-mappa magħżula

1. Fil-callback onSelect, aċċessa result.data.

   Din fiha d-data tal-mappa fil-format li talbet.
    

2. (Opzjonali) Uża l-kampi addizzjonali rritornati:

   • result.title — it-titlu tal-mappa
   • result.mapCode — il-kodiċi tal-mappa ta' Scribble Maps
   • result.thumbUrl — URL ta' thumbnail għall-mappa
    

3. Għaddi d-data fil-loġika tal-applikazzjoni tiegħek.

   Pereżempju, ittallaq il-GeoJSON rritornat fil-viewer tal-mappi tiegħek stess jew fil-workflow tad-data tiegħek.

Ara l-Werrej ↑

Konfigurazzjoni opzjonali

Tista' tikkonfigura l-picker biex jaqbel aħjar mal-workflow tal-applikazzjoni tiegħek.

1. Agħżel il-format tal-esportazzjoni billi tbiddel il-valur format.

   Pereżempju: geojson, kml, csv, gpx, dxf, shapefile, jew smjson.
    

2. Agħżel liema sorsi ta' mappi jistgħu jfittxu l-utenti bl-għażla tabs.

   L-utenti jistgħu jfittxu mappi mil-librerija personali tagħhom, minn mappi maqsuma mat-tim, jew mill-kollezzjoni tal-komunità.
    
3. (Opzjonali) Uża l-istili tal-buttuni inklużi biex jaqblu ma' interface ċara jew skura.

Ara l-Werrej ↑

Formati appoġġati u kampi rritornati

Formati ta' esportazzjoni appoġġati:

• GeoJSON
• KML
• CSV
• GPX
• DXF
• Shapefile
• SMJSON

Kampi tar-riżultat rritornati:

• data
• title
• mapCode
• thumbUrl

Ladarba jkun ikkonfigurat, il-Connect Picker jagħti lill-utenti tiegħek aċċess għad-data ta' Scribble Maps tagħhom direttament minn ġewwa l-applikazzjoni tiegħek permezz ta' punt wieħed ta' integrazzjoni.

Relatat

Scribble Maps Developers

Scribble Maps Connect Picker

Import/Export Files & Data - GeoJSON, images, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, etc.

Import/Export: Descriptions, Examples, Restrictions and Workarounds - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP