Nota:

Usa o ScribbleMaps Connect Picker cando queiras que os usuarios inicien sesión en Scribble Maps, exploren os seus mapas dispoñibles e devolvan os datos do mapa directamente á túa aplicación web.

 

O selector ábrese nunha xanela emerxente e xestiona alí o proceso de inicio de sesión do usuario, polo que a túa aplicación non necesita recoller directamente as credenciais de Scribble Maps.

Contidos

Como funciona o Connect Picker

O ScribbleMaps Connect Picker permite aos teus usuarios explorar, buscar e seleccionar mapas de Scribble Maps e despois devolver eses datos do mapa directamente á túa aplicación no formato que elixas.

Isto é útil cando queres que os usuarios creen ou xestionen datos xeográficos en Scribble Maps e despois carguen eses datos na túa propia aplicación sen ter que construír o teu propio explorador de mapas nin fluxo de inicio de sesión.

Caso de uso / Exemplo:

Esta integración é útil para paneis de control, ferramentas inmobiliarias, aplicacións de datos de campo e outras aplicacións web que necesitan que os usuarios seleccionen e carguen datos cartografados desde Scribble Maps.

Ver contidos ↑

Obtén o teu Client ID

1. Abre o sitio de desenvolvedores de Scribble Maps:
   https://developers.scribblemaps.com

    

2. Rexistra un proxecto gratuíto.

    

3. Copia o teu Client ID.

   Usarás este valor ao chamar ao Connect Picker.

Ver contidos ↑

Engade o SDK á túa páxina

1. Na túa páxina web, engade o SDK do Connect Picker:

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

    

2. Garda os cambios da túa páxina.

   O Scribble Maps Connect Picker xa está dispoñible para a túa aplicación.

Ver contidos ↑

Abre o Connect Picker

1. Chama a ScribbleMapsConnect.pick() desde a túa páxina.

    

2. Pasa o teu clientId, o format de exportación que queres e unha función de retorno onSelect.

    

3. Usa código semellante ao seguinte exemplo:

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

   Cando se abre o selector, o usuario pode autenticarse, explorar os seus mapas dispoñibles e seleccionar un.

Ver contidos ↑

Xestiona os datos do mapa seleccionado

1. Na función de retorno onSelect, accede a result.data.

   Isto contén os datos do mapa no formato que solicitaches.
    

2. (Opcional) Usa os campos adicionais devoltos:

   • result.title — o título do mapa
   • result.mapCode — o código do mapa de Scribble Maps
   • result.thumbUrl — un URL de miniatura do mapa
    

3. Pasa os datos á lóxica da túa aplicación.

   Por exemplo, carga o GeoJSON devolto no teu propio visor de mapas ou fluxo de datos.

Ver contidos ↑

Configuración opcional

Podes configurar o selector para que se adapte mellor ao fluxo de traballo da túa aplicación.

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

   Por exemplo: geojson, kml, csv, gpx, dxf, shapefile ou smjson.
    

2. Elixe que orixes de mapas poden explorar os usuarios coa opción tabs.

   Os usuarios poden explorar mapas da súa biblioteca persoal, mapas compartidos polo equipo ou a colección da comunidade.
    
3. (Opcional) Usa os estilos de botón incluídos para axustarte a unha interface clara ou escura.

Ver contidos ↑

Formatos admitidos e campos devoltos

Formatos de exportación admitidos:

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

Campos de resultado devoltos:

• data
• title
• mapCode
• thumbUrl

Unha vez configurado, o Connect Picker dá aos teus usuarios acceso aos seus datos de Scribble Maps directamente desde a túa aplicación a través dun único punto de integración.

Relacionado

Scribble Maps Developers

Scribble Maps Connect Picker

Importar/Exportar ficheiros e datos - GeoJSON, imaxes, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, etc.

Importar/Exportar: descricións, exemplos, restricións e solucións alternativas - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP