Nota:

Usa lo ScribbleMaps Connect Picker quando desideri che gli utenti accedano a Scribble Maps, sfoglino le loro mappe disponibili e restituiscano i dati della mappa direttamente alla tua applicazione web.

 

Il selettore si apre in un popup e gestisce il processo di accesso dell'utente da lì, in modo che la tua applicazione non debba raccogliere direttamente le credenziali di Scribble Maps.

Indice

Come funziona il Connect Picker

Lo ScribbleMaps Connect Picker consente ai tuoi utenti di sfogliare, cercare e selezionare mappe da Scribble Maps, per poi restituire i dati di tali mappe direttamente alla tua applicazione nel formato scelto.

Questo è utile quando desideri che gli utenti creino o gestiscano geodati in Scribble Maps e poi carichino tali dati nella tua app senza dover creare un browser di mappe o un flusso di accesso personalizzato.

Caso d'uso / Esempio:

Questa integrazione è utile per dashboard, strumenti immobiliari, applicazioni per dati sul campo e altre app web che richiedono agli utenti di selezionare e caricare dati mappati da Scribble Maps.

Visualizza Indice ↑

Ottieni il tuo Client ID

1. Apri il sito per sviluppatori di Scribble Maps:
   https://developers.scribblemaps.com

    

2. Registra un progetto gratuito.

    

3. Copia il tuo Client ID.

   Utilizzerai questo valore quando chiami il Connect Picker.

Visualizza Indice ↑

Aggiungi l'SDK alla tua pagina

1. Nella tua pagina web, aggiungi l'SDK del Connect Picker:

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

    

2. Salva le modifiche alla pagina.

   Lo Scribble Maps Connect Picker è ora disponibile per la tua applicazione.

Visualizza Indice ↑

Apri il Connect Picker

1. Chiama ScribbleMapsConnect.pick() dalla tua pagina.

    

2. Passa il tuo clientId, il format di esportazione desiderato e una callback onSelect.

    

3. Usa un codice simile al seguente esempio:

   ScribbleMapsConnect.pick({
     clientId: 'YOUR_CLIENT_ID',
     format: 'geojson',
     onSelect: function (result) {
       // result.data contiene il tuo GeoJSON
       // sono disponibili anche result.title, result.mapCode, result.thumbUrl
       loadIntoMyApp(result.data);
     }
   });

   Quando il selettore si apre, l'utente può autenticarsi, sfogliare le proprie mappe disponibili e selezionarne una.

Visualizza Indice ↑

Gestisci i dati della mappa selezionata

1. Nella callback onSelect, accedi a result.data.

   Questo contiene i dati della mappa nel formato richiesto.
    

2. (Opzionale) Utilizza i campi aggiuntivi restituiti:

   • result.title — il titolo della mappa
   • result.mapCode — il codice mappa di Scribble Maps
   • result.thumbUrl — un URL della miniatura della mappa
    

3. Passa i dati alla logica della tua applicazione.

   Ad esempio, carica il GeoJSON restituito nel tuo visualizzatore di mappe o nel tuo flusso di lavoro dei dati.

Visualizza Indice ↑

Configurazione opzionale

Puoi configurare il selettore per adattarlo meglio al flusso di lavoro della tua applicazione.

1. Seleziona il formato di esportazione modificando il valore di format.

   Ad esempio: geojson, kml, csv, gpx, dxf, shapefile o smjson.
    

2. Scegli quali sorgenti di mappe gli utenti possono sfogliare con l'opzione tabs.

   Gli utenti possono sfogliare le mappe dalla loro libreria personale, dalle mappe condivise del team o dalla raccolta della community.
    
3. (Opzionale) Usa gli stili dei pulsanti inclusi per adattarli a un'interfaccia chiara o scura.

Visualizza Indice ↑

Formati supportati e campi restituiti

Formati di esportazione supportati:

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

Campi dei risultati restituiti:

• data
• title
• mapCode
• thumbUrl

Una volta configurato, il Connect Picker consente ai tuoi utenti di accedere ai propri dati di Scribble Maps direttamente dall'interno della tua applicazione attraverso un unico punto di integrazione.

Correlati

Sviluppatori Scribble Maps

Scribble Maps Connect Picker

Importa/Esporta file e dati - GeoJSON, immagini, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, ecc.

Importa/Esporta: descrizioni, esempi, restrizioni e soluzioni alternative - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP