Notă:

Utilizați ScribbleMaps Connect Picker atunci când doriți ca utilizatorii să se conecteze la Scribble Maps, să își răsfoiască hărțile disponibile și să returneze datele hărții direct în aplicația dvs. web.

 

Selectorul se deschide într-o fereastră pop-up și gestionează procesul de conectare a utilizatorului acolo, astfel încât aplicația dvs. nu trebuie să colecteze direct datele de conectare Scribble Maps.

Cuprins

Cum funcționează Connect Picker

ScribbleMaps Connect Picker permite utilizatorilor dvs. să răsfoiască, să caute și să selecteze hărți din Scribble Maps, apoi să returneze acele date ale hărții direct în aplicația dvs. în formatul pe care îl alegeți.

Acest lucru este util atunci când doriți ca utilizatorii să creeze sau să gestioneze geo-date în Scribble Maps și apoi să încarce acele date în propria dvs. aplicație fără a construi propriul browser de hărți sau flux de conectare.

Caz de utilizare / Exemplu:

Această integrare este utilă pentru tablouri de bord, instrumente imobiliare, aplicații pentru date de teren și alte aplicații web care necesită ca utilizatorii să selecteze și să încarce date cartografiate din Scribble Maps.

Vizualizare cuprins ↑

Obțineți codul de Client ID

1. Deschideți site-ul pentru dezvoltatori Scribble Maps:
   https://developers.scribblemaps.com

    

2. Înregistrați un proiect gratuit.

    

3. Copiați codul dvs. Client ID.

   Veți folosi această valoare atunci când apelați Connect Picker.

Vizualizare cuprins ↑

Adăugați SDK-ul în pagina dvs.

1. În pagina dvs. web, adăugați SDK-ul Connect Picker:

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

    

2. Salvați modificările paginii.

   Scribble Maps Connect Picker este acum disponibil pentru aplicația dvs.

Vizualizare cuprins ↑

Deschideți Connect Picker

1. Apelați ScribbleMapsConnect.pick() din pagina dvs.

    

2. Transmiteți codul dvs. clientId, formatul de export (format) pe care îl doriți și o funcție de apel invers (callback) onSelect.

    

3. Utilizați un cod similar cu următorul exemplu:

   ScribbleMapsConnect.pick({
     clientId: 'YOUR_CLIENT_ID',
     format: 'geojson',
     onSelect: function (result) {
       // result.data conține GeoJSON-ul dvs.
       // result.title, result.mapCode, result.thumbUrl sunt de asemenea disponibile
       loadIntoMyApp(result.data);
     }
   });

   Când se deschide selectorul, utilizatorul se poate autentifica, își poate răsfoi hărțile disponibile și poate selecta una.

Vizualizare cuprins ↑

Gestionați datele hărții selectate

1. În funcția de apel invers onSelect, accesați result.data.

   Acesta conține datele hărții în formatul pe care l-ați solicitat.
    

2. (Opțional) Utilizați câmpurile suplimentare returnate:

   • result.title — titlul hărții
   • result.mapCode — codul de hartă Scribble Maps
   • result.thumbUrl — o adresă URL a miniaturii pentru hartă
    

3. Transmiteți datele în logica aplicației dvs.

   De exemplu, încărcați GeoJSON-ul returnat în propriul vizualizator de hărți sau flux de lucru de date.

Vizualizare cuprins ↑

Configurare opțională

Puteți configura selectorul pentru a se potrivi mai bine cu fluxul de lucru al aplicației dvs.

1. Selectați formatul de export prin modificarea valorii format.

   De exemplu: geojson, kml, csv, gpx, dxf, shapefile sau smjson.
    

2. Alegeți ce surse de hărți pot răsfoi utilizatorii cu opțiunea tabs.

   Utilizatorii pot răsfoi hărți din personal library, team-shared maps sau community collection.
    
3. (Opțional) Utilizați stilurile de butoane incluse pentru a se potrivi cu o interfață light sau dark.

Vizualizare cuprins ↑

Formate acceptate și câmpuri returnate

Formate de export acceptate:

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

Câmpuri de rezultate returnate:

• data
• title
• mapCode
• thumbUrl

Odată configurat, Connect Picker oferă utilizatorilor dvs. acces la datele lor Scribble Maps direct din cadrul aplicației dvs. printr-un singur punct de integrare.

Articole înrudite

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