ScribbleMaps toevoegen aan uw app
Opmerking:Gebruik de ScribbleMaps Connect Picker wanneer u wilt dat gebruikers zich aanmelden bij Scribble Maps, door hun beschikbare kaarten bladeren en kaartgegevens rechtstreeks naar uw webapplicatie sturen.De picker opent in een pop-up en regelt daar het aanmeldingsproces voor de gebruiker, zodat uw applicatie niet rechtstreeks inloggegevens voor Scribble Maps hoeft te verzamelen.
Inhoud
Haal uw Client ID op
Voeg de SDK toe aan uw pagina
Open the Connect Picker
Verwerk de geselecteerde kaartgegevens
Optionele configuratie
Ondersteunde formaten en geretourneerde velden
Hoe de Connect Picker werkt
Met de ScribbleMaps Connect Picker kunnen uw gebruikers kaarten in Scribble Maps zoeken, bekijken en selecteren, en die kaartgegevens vervolgens rechtstreeks in het door u gekozen formaat naar uw applicatie sturen.
Dit is handig wanneer u wilt dat gebruikers geogegevens maken of beheren in Scribble Maps en die gegevens vervolgens in uw eigen app laden zonder dat u uw eigen kaartbrowser of aanmeldingsstroom hoeft te bouwen.
Use Case / Voorbeeld:
Deze integratie is handig voor dashboards, vastgoedtools, veldgegevensapplicaties en andere web-apps waarbij gebruikers in kaart gebrachte gegevens van Scribble Maps moeten selecteren en laden.
Haal uw Client ID op
-
Open de Scribble Maps-ontwikkelaarssite:
https://developers.scribblemaps.com -
Registreer een gratis project.
-
Kopieer uw Client ID.
U gebruikt deze waarde bij het aanroepen van de Connect Picker.
Voeg de SDK toe aan uw pagina
-
Voeg de Connect Picker SDK toe aan uw webpagina:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Sla de wijzigingen aan uw pagina op.
De Scribble Maps Connect Picker is nu beschikbaar voor uw applicatie.
Open the Connect Picker
-
Roep ScribbleMapsConnect.pick() aan vanaf uw pagina.
-
Geef uw clientId, het gewenste export-format en een onSelect-callback door.
-
Gebruik code die vergelijkbaar is met het volgende voorbeeld:
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); } });Wanneer de picker opent, kan de gebruiker zich authenticeren, door zijn beschikbare kaarten bladeren en er een selecteren.
Verwerk de geselecteerde kaartgegevens
-
Krijg in de onSelect-callback toegang tot result.data.
Dit bevat de kaartgegevens in het door u aangevraagde formaat. -
(Optioneel) Gebruik de extra geretourneerde velden:
- result.title — de kaarttitel
- result.mapCode — de Scribble Maps-kaartcode
- result.thumbUrl — een thumbnail-URL voor de kaart
-
Geef de gegevens door aan uw applicatielogica.
Laad bijvoorbeeld de geretourneerde GeoJSON in uw eigen kaartviewer of gegevensworkflow.
Optionele configuratie
U kunt de picker configureren om beter aan te sluiten op de workflow van uw applicatie.
-
Selecteer het exportformaat door de waarde van format te wijzigen.
Bijvoorbeeld: geojson, kml, csv, gpx, dxf, shapefile of smjson. -
Kies door welke kaartbronnen gebruikers kunnen bladeren met de optie tabs.
Gebruikers kunnen bladeren door kaarten uit hun personal library, team-shared maps of de community collection. - (Optioneel) Gebruik de meegeleverde knopstijlen die passen bij een light of dark interface.
Ondersteunde formaten en geretourneerde velden
Ondersteunde exportformaten:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Geretourneerde resultaatvelden:
- data
- title
- mapCode
- thumbUrl
Eenmaal geconfigureerd, geeft de Connect Picker uw gebruikers rechtstreeks vanuit uw applicatie toegang tot hun Scribble Maps-gegevens via één enkel integratiepunt.
Gerelateerd
Laatst bijgewerkt