Nota:

Utilitza el ScribbleMaps Connect Picker quan vulguis que els usuaris iniciïn la sessió a Scribble Maps, exploris els seus mapes disponibles i retornin les dades del mapa directament a la teva aplicació web.

 

El selector s'obre en una finestra emergent i gestiona allà el procés d'inici de sessió de l'usuari, de manera que la teva aplicació no ha de recollir directament les credencials de Scribble Maps.

Contingut

Com funciona el Connect Picker

El ScribbleMaps Connect Picker permet que els teus usuaris explorin, cerquin i seleccionin mapes de Scribble Maps, i després retorna aquestes dades del mapa directament a la teva aplicació en el format que triïs.

Això és útil quan vols que els usuaris creïn o gestionin dades geogràfiques a Scribble Maps i després les carreguin a la teva pròpia aplicació sense haver de crear el teu propi explorador de mapes ni el teu propi flux d'inici de sessió.

Cas d'ús / Exemple:

Aquesta integració és útil per a quadres de comandament, eines immobiliàries, aplicacions de dades de camp i altres aplicacions web que necessiten que els usuaris seleccionin i carreguin dades cartografiades de Scribble Maps.

Mostra el contingut ↑

Obtén el teu Client ID

1. Obre el lloc web per a desenvolupadors de Scribble Maps:
   https://developers.scribblemaps.com

    

2. Registra un projecte gratuït.

    

3. Copia el teu Client ID.

   Utilitzaràs aquest valor quan cridis el Connect Picker.

Mostra el contingut ↑

Afegeix l'SDK a la teva pàgina

1. A la teva pàgina web, afegeix l'SDK del Connect Picker:

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

    

2. Desa els canvis de la teva pàgina.

   El Scribble Maps Connect Picker ja està disponible per a la teva aplicació.

Mostra el contingut ↑

Obre el Connect Picker

1. Crida ScribbleMapsConnect.pick() des de la teva pàgina.

    

2. Passa el teu clientId, el format d'exportació que vulguis i una funció de retorn onSelect.

    

3. Utilitza un codi semblant al d'aquest exemple:

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

   Quan s'obre el selector, l'usuari pot autenticar-se, explorar els seus mapes disponibles i seleccionar-ne un.

Mostra el contingut ↑

Gestiona les dades del mapa seleccionat

1. A la funció de retorn onSelect, accedeix a result.data.

   Conté les dades del mapa en el format que has sol·licitat.
    

2. (Opcional) Utilitza els camps addicionals retornats:

   • result.title — el títol del mapa
   • result.mapCode — el codi del mapa de Scribble Maps
   • result.thumbUrl — un URL de la miniatura del mapa
    

3. Passa les dades a la lògica de la teva aplicació.

   Per exemple, carrega el GeoJSON retornat al teu propi visor de mapes o flux de treball de dades.

Mostra el contingut ↑

Configuració opcional

Pots configurar el selector perquè s'adapti millor al flux de treball de la teva aplicació.

1. Selecciona el format d'exportació canviant el valor de format.

   Per exemple: geojson, kml, csv, gpx, dxf, shapefile o smjson.
    

2. Tria quines fonts de mapes poden explorar els usuaris amb l'opció tabs.

   Els usuaris poden explorar mapes de la seva biblioteca personal, mapes compartits de l'equip o la col·lecció de la comunitat.
    
3. (Opcional) Utilitza els estils de botó inclosos per fer-los coincidir amb una interfície clara o fosca.

Mostra el contingut ↑

Formats compatibles i camps retornats

Formats d'exportació compatibles:

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

Camps del resultat retornats:

• data
• title
• mapCode
• thumbUrl

Una vegada configurat, el Connect Picker dona als teus usuaris accés a les seves dades de Scribble Maps directament des de la teva aplicació mitjançant un únic punt d'integració.

Relacionat

Scribble Maps Developers

Scribble Maps Connect Picker

Importa/Exporta fitxers i dades - GeoJSON, imatges, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, etc.

Importa/Exporta: descripcions, exemples, restriccions i solucions alternatives - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP