Pridajte ScribbleMaps do svojej aplikácie
Poznámka:Použite ScribbleMaps Connect Picker, keď chcete, aby sa používatelia prihlásili do Scribble Maps, prehliadali svoje dostupné mapy a vracali údaje mapy priamo do vašej webovej aplikácie.Výber sa otvorí v automaticky otváranom okne a prihlásenie používateľa sa rieši tam, takže vaša aplikácia nemusí zbierať prihlasovacie údaje do Scribble Maps priamo.
Obsah
Získajte svoje Client ID
Pridajte SDK na svoju stránku
Otvorte Connect Picker
Spracovanie vybraných údajov mapy
Voliteľná konfigurácia
Podporované formáty a vrátené polia
Ako funguje Connect Picker
ScribbleMaps Connect Picker umožňuje vašim používateľom prehliadať, vyhľadávať a vyberať mapy zo Scribble Maps a potom vrátiť tieto údaje mapy priamo do vašej aplikácie vo formáte, ktorý si zvolíte.
Je to užitočné, keď chcete, aby používatelia vytvárali alebo spravovali geografické údaje v Scribble Maps a potom ich načítali do vašej vlastnej aplikácie bez toho, aby ste museli budovať vlastný prehliadač máp alebo proces prihlásenia.
Prípad použitia / Príklad:
Táto integrácia je užitočná pre dashboardy, nástroje pre nehnuteľnosti, aplikácie na terénne údaje a iné webové aplikácie, ktoré potrebujú, aby používatelia vyberali a načítavali mapové údaje zo Scribble Maps.
Získajte svoje Client ID
-
Otvorte vývojársku stránku Scribble Maps:
https://developers.scribblemaps.com -
Zaregistrujte bezplatný projekt.
-
Skopírujte svoje Client ID.
Túto hodnotu použijete pri volaní Connect Picker.
Pridajte SDK na svoju stránku
-
Na svoju webovú stránku pridajte SDK pre Connect Picker:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Uložte zmeny na stránke.
Scribble Maps Connect Picker je teraz dostupný vašej aplikácii.
Otvorte Connect Picker
-
Zavolajte ScribbleMapsConnect.pick() zo svojej stránky.
-
Odovzdajte svoje clientId, požadovaný exportný format a spätné volanie onSelect.
-
Použite kód podobný nasledujúcemu príkladu:
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); } });Keď sa výber otvorí, používateľ sa môže overiť, prehliadať svoje dostupné mapy a vybrať jednu z nich.
Spracovanie vybraných údajov mapy
-
V spätnom volaní onSelect pristupujte k result.data.
Obsahuje údaje mapy vo formáte, ktorý ste požadovali. -
(Voliteľné) Použite ďalšie vrátené polia:
- result.title — názov mapy
- result.mapCode — kód mapy Scribble Maps
- result.thumbUrl — URL miniatúry mapy
-
Odovzdajte údaje do logiky svojej aplikácie.
Napríklad načítajte vrátený GeoJSON do vlastného prehliadača máp alebo dátového pracovného postupu.
Voliteľná konfigurácia
Výber môžete nakonfigurovať tak, aby lepšie zodpovedal pracovnému postupu vašej aplikácie.
-
Vyberte exportný formát zmenou hodnoty format.
Napríklad: geojson, kml, csv, gpx, dxf, shapefile alebo smjson. -
Vyberte, ktoré zdroje máp môžu používatelia prehliadať pomocou možnosti tabs.
Používatelia môžu prehliadať mapy zo svojej osobnej knižnice, máp zdieľaných tímom alebo komunitnej kolekcie. - (Voliteľné) Použite priložené štýly tlačidiel, aby zodpovedali svetlému alebo tmavému rozhraniu.
Podporované formáty a vrátené polia
Podporované exportné formáty:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Vrátené polia výsledku:
- data
- title
- mapCode
- thumbUrl
Po nakonfigurovaní poskytuje Connect Picker vašim používateľom prístup k ich údajom zo Scribble Maps priamo z vašej aplikácie prostredníctvom jediného integračného bodu.
Súvisiace
Import/Export: popisy, príklady, obmedzenia a riešenia – CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP
Naposledy aktualizované