Lägg till ScribbleMaps i din app
Anteckning:Använd ScribbleMaps Connect Picker när du vill att användare ska logga in på Scribble Maps, bläddra bland sina tillgängliga kartor och skicka kartdata direkt till din webbapplikation.Väljaren öppnas i ett popup-fönster och hanterar användarens inloggningsprocess där, så din applikation behöver inte samla in Scribble Maps-inloggningsuppgifter direkt.
Innehåll
Hämta ditt Client-ID
Lägg till SDK:n på din sida
Öppna Connect Picker
Hantera den valda kartdatan
Valfri konfiguration
Format som stöds och returnerade fält
Hur Connect Picker fungerar
ScribbleMaps Connect Picker låter dina användare bläddra, söka och välja kartor från Scribble Maps, och sedan skicka den kartdatan direkt till din applikation i det format du väljer.
Detta är användbart när du vill att användare ska skapa eller hantera geodata i Scribble Maps och sedan läsa in den datan i din egen app utan att bygga en egen kartbläddrare eller inloggningsflöde.
Användningsfall/Exempel:
Den här integrationen är användbar för instrumentpaneler, fastighetsverktyg, fältdataapplikationer och andra webbappar som behöver att användare väljer och läser in kartlagd data från Scribble Maps.
Hämta ditt Client-ID
-
Öppna Scribble Maps utvecklarsida:
https://developers.scribblemaps.com -
Registrera ett gratis projekt.
-
Kopiera ditt Client-ID.
Du kommer att använda detta värde när du anropar Connect Picker.
Lägg till SDK:n på din sida
-
Lägg till Connect Picker SDK:n på din webbsida:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Spara ändringarna på din sida.
Scribble Maps Connect Picker är nu tillgänglig för din applikation.
Öppna Connect Picker
-
Anropa ScribbleMapsConnect.pick() från din sida.
-
Skicka med ditt clientId, det exportformat (format) du vill ha, och en onSelect-callback.
-
Använd kod liknande följande exempel:
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); } });När väljaren öppnas kan användaren autentisera sig, bläddra bland sina tillgängliga kartor och välja en.
Hantera den valda kartdatan
-
I onSelect-callbacken, kom åt result.data.
Detta innehåller kartdatan i det format du begärde. -
(Valfritt) Använd de ytterligare returnerade fälten:
- result.title — karttiteln
- result.mapCode — Scribble Maps kartkoden
- result.thumbUrl — en miniatyrbilds-URL för kartan
-
Skicka datan till din applikationslogik.
Läs till exempel in den returnerade GeoJSON-datan i din egen kartvisare eller ditt dataarbetsflöde.
Valfri konfiguration
Du kan konfigurera väljaren så att den bättre matchar din applikations arbetsflöde.
-
Välj exportformat genom att ändra värdet för format.
Till exempel: geojson, kml, csv, gpx, dxf, shapefile, eller smjson. -
Välj vilka kartkällor användare kan bläddra bland med alternativet tabs.
Användare kan bläddra bland kartor från sitt personliga bibliotek, team-delade kartor, eller gemenskapssamlingen. - (Valfritt) Använd de medföljande knappstilarna för att matcha ett ljust eller mörkt gränssnitt.
Format som stöds och returnerade fält
Exportformat som stöds:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Returnerade resultatfält:
- data
- title
- mapCode
- thumbUrl
När den är konfigurerad ger Connect Picker dina användare tillgång till sin Scribble Maps-data direkt inifrån din applikation genom en enda integrationspunkt.
Relaterat
Last updated