Tilføj ScribbleMaps til din app
Bemærk:Brug ScribbleMaps Connect Picker, når du vil have brugere til at logge ind på Scribble Maps, gennemse deres tilgængelige kort og returnere kortdata direkte til din webapplikation.Pickeren åbnes i en popup og håndterer brugerens loginproces der, så din applikation ikke behøver at indsamle Scribble Maps-loginoplysninger direkte.
Indhold
Hent dit Client ID
Tilføj SDK'et til din side
Åbn Connect Picker
Håndter de valgte kortdata
Valgfri konfiguration
Understøttede formater og returnerede felter
Sådan fungerer Connect Picker
ScribbleMaps Connect Picker giver dine brugere mulighed for at gennemse, søge i og vælge kort fra Scribble Maps og derefter returnere disse kortdata direkte til din applikation i det format, du vælger.
Dette er nyttigt, når du vil have brugere til at oprette eller administrere geodata i Scribble Maps og derefter indlæse disse data i din egen app uden at skulle bygge din egen kortbrowser eller dit eget loginflow.
Anvendelsesscenarie / Eksempel:
Denne integration er nyttig til dashboards, ejendomsværktøjer, feltdataapplikationer og andre webapps, hvor brugere skal vælge og indlæse kortlagte data fra Scribble Maps.
Hent dit Client ID
-
Åbn Scribble Maps' udviklerwebsted:
https://developers.scribblemaps.com -
Registrer et gratis projekt.
-
Kopier dit Client ID.
Du skal bruge denne værdi, når du kalder Connect Picker.
Tilføj SDK'et til din side
-
Tilføj Connect Picker SDK'et på din webside:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Gem dine ændringer på siden.
Scribble Maps Connect Picker er nu tilgængelig for din applikation.
Åbn Connect Picker
-
Kald ScribbleMapsConnect.pick() fra din side.
-
Angiv dit clientId, det ønskede eksport-format og et onSelect-callback.
-
Brug en kode, der ligner følgende eksempel:
ScribbleMapsConnect.pick({ clientId: 'YOUR_CLIENT_ID', format: 'geojson', onSelect: function (result) { // result.data indeholder din GeoJSON // result.title, result.mapCode, result.thumbUrl er også tilgængelige loadIntoMyApp(result.data); } });Når pickeren åbnes, kan brugeren godkende, gennemse sine tilgængelige kort og vælge et.
Håndter de valgte kortdata
-
I onSelect-callbacket skal du tilgå result.data.
Dette indeholder kortdataene i det format, du anmodede om. -
(Valgfrit) Brug de yderligere returnerede felter:
- result.title — kortets titel
- result.mapCode — Scribble Maps-kortkoden
- result.thumbUrl — en URL til kortets miniaturebillede
-
Send dataene videre til din applikationslogik.
For eksempel kan du indlæse den returnerede GeoJSON i din egen kortviser eller dit eget dataworkflow.
Valgfri konfiguration
Du kan konfigurere pickeren, så den passer bedre til dit applikationsworkflow.
-
Vælg eksportformatet ved at ændre værdien for format.
For eksempel: geojson, kml, csv, gpx, dxf, shapefile eller smjson. -
Vælg, hvilke kortkilder brugerne kan gennemse med indstillingen tabs.
Brugere kan gennemse kort fra deres personlige bibliotek, teamdelte kort eller fællesskabssamlingen. - (Valgfrit) Brug de medfølgende knapstile til at matche en lys eller mørk grænseflade.
Understøttede formater og returnerede felter
Understøttede eksportformater:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Returnerede resultatfelter:
- data
- title
- mapCode
- thumbUrl
Når den er konfigureret, giver Connect Picker dine brugere adgang til deres Scribble Maps-data direkte inde fra din applikation via et enkelt integrationspunkt.
Relateret
Senest opdateret