Nota:

Utiliza el ScribbleMaps Connect Picker cuando quieras que los usuarios inicien sesión en Scribble Maps, exploren sus mapas disponibles y devuelvan los datos del mapa directamente a tu aplicación web.

 

El selector se abre en una ventana emergente y gestiona el proceso de inicio de sesión del usuario allí, por lo que tu aplicación no necesita recopilar las credenciales de Scribble Maps directamente.

Contenido

Cómo funciona el Connect Picker

El ScribbleMaps Connect Picker permite a tus usuarios explorar, buscar y seleccionar mapas de Scribble Maps, y luego devolver esos datos de mapa directamente a tu aplicación en el formato que elijas.

Esto es útil cuando deseas que los usuarios creen o gestionen geodatos en Scribble Maps y luego carguen esos datos en tu propia aplicación sin tener que crear tu propio explorador de mapas o flujo de inicio de sesión.

Caso de uso / Ejemplo:

Esta integración es útil para paneles de control, herramientas inmobiliarias, aplicaciones de datos de campo y otras aplicaciones web que necesitan que los usuarios seleccionen y carguen datos mapeados desde Scribble Maps.

Ver contenido ↑

Obtén tu Client ID

1. Abre el sitio para desarrolladores de Scribble Maps:
   https://developers.scribblemaps.com

    

2. Registra un proyecto gratuito.

    

3. Copia tu Client ID.

   Utilizarás este valor al llamar al Connect Picker.

Ver contenido ↑

Añade el SDK a tu página

1. En tu página web, añade el SDK del Connect Picker:

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

    

2. Guarda los cambios de tu página.

   El Scribble Maps Connect Picker ahora está disponible para tu aplicación.

Ver contenido ↑

Abre el Connect Picker

1. Llama a ScribbleMapsConnect.pick() desde tu página.

    

2. Pasa tu clientId, el format de exportación que deseas y una función de devolución de llamada onSelect.

    

3. Utiliza un código similar al del siguiente ejemplo:

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

   Cuando se abra el selector, el usuario podrá autenticarse, explorar sus mapas disponibles y seleccionar uno.

Ver contenido ↑

Gestiona los datos del mapa seleccionado

1. En la función de devolución de llamada onSelect, accede a result.data.

   Esto contiene los datos del mapa en el formato que solicitaste.
    

2. (Opcional) Utiliza los campos adicionales devueltos:

   • result.title — el título del mapa
   • result.mapCode — el código de mapa de Scribble Maps
   • result.thumbUrl — una URL de miniatura para el mapa
    

3. Pasa los datos a la lógica de tu aplicación.

   Por ejemplo, carga el GeoJSON devuelto en tu propio visor de mapas o flujo de trabajo de datos.

Ver contenido ↑

Configuración opcional

Puedes configurar el selector para que se adapte mejor al flujo de trabajo de tu aplicación.

1. Selecciona el formato de exportación cambiando el valor de format.

   Por ejemplo: geojson, kml, csv, gpx, dxf, shapefile o smjson.
    

2. Elige qué fuentes de mapas pueden explorar los usuarios con la opción tabs.

   Los usuarios pueden explorar mapas de su biblioteca personal, mapas compartidos con el equipo o la colección de la comunidad.
    
3. (Opcional) Utiliza los estilos de botón incluidos para que coincidan con una interfaz clara o oscura.

Ver contenido ↑

Formatos admitidos y campos devueltos

Formatos de exportación admitidos:

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

Campos de resultado devueltos:

• data
• title
• mapCode
• thumbUrl

Una vez configurado, el Connect Picker ofrece a tus usuarios acceso a sus datos de Scribble Maps directamente desde tu aplicación a través de un único punto de integración.

Relacionado

Scribble Maps Developers

Scribble Maps Connect Picker

Importar/Exportar archivos y datos: GeoJSON, imágenes, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, etc.

Importar/Exportar: descripciones, ejemplos, restricciones y soluciones alternativas: CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP