ScribbleMaps hozzáadása az alkalmazásához
Megjegyzés:Használja a ScribbleMaps Connect Picker-t, ha azt szeretné, hogy a felhasználók bejelentkezzenek a Scribble Maps-be, böngésszék az elérhető térképeiket, és a térképadatokat közvetlenül visszaadják a webalkalmazásának.A választó egy előugró ablakban nyílik meg, és ott kezeli a felhasználói bejelentkezési folyamatot, így az alkalmazásának nem kell közvetlenül begyűjtenie a Scribble Maps hitelesítő adatait.
Tartalom
Client ID beszerzése
Az SDK hozzáadása az oldalhoz
A Connect Picker megnyitása
A kiválasztott térképadatok kezelése
Opcionális konfiguráció
Támogatott formátumok és visszaadott mezők
Hogyan működik a Connect Picker
A ScribbleMaps Connect Picker lehetővé teszi a felhasználók számára, hogy böngésszenek, keressenek és kiválasszanak térképeket a Scribble Maps-ből, majd a térképadatokat az Ön által választott formátumban közvetlenül visszaadja az alkalmazásának.
Ez akkor hasznos, ha azt szeretné, hogy a felhasználók a Scribble Maps-ben hozzanak létre vagy kezeljenek földrajzi adatokat, majd ezeket az adatokat betöltsék az Ön saját alkalmazásába anélkül, hogy saját térképböngészőt vagy bejelentkezési folyamatot kellene építenie.
Felhasználási eset / Példa:
Ez az integráció hasznos irányítópultokhoz, ingatlankezelő eszközökhöz, terepi adatgyűjtő alkalmazásokhoz és más webalkalmazásokhoz, amelyeknek szükségük van arra, hogy a felhasználók kiválasszák és betöltsék a Scribble Maps-ben szereplő térképezett adatokat.
Client ID beszerzése
-
Nyissa meg a Scribble Maps fejlesztői webhelyét:
https://developers.scribblemaps.com -
Regisztráljon egy ingyenes projektet.
-
Másolja ki a Client ID-t.
Ezt az értéket fogja használni a Connect Picker meghívásakor.
Az SDK hozzáadása az oldalhoz
-
Adja hozzá a Connect Picker SDK-t a weboldalához:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Mentse az oldalon végzett módosításokat.
A Scribble Maps Connect Picker mostantól elérhető az alkalmazása számára.
A Connect Picker megnyitása
-
Hívja meg a ScribbleMapsConnect.pick() függvényt az oldaláról.
-
Adja át a clientId-t, a kívánt exportálási format-ot és egy onSelect visszahívást.
-
Használjon a következő példához hasonló kódot:
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); } });Amikor a választó megnyílik, a felhasználó hitelesítheti magát, böngészheti az elérhető térképeit, és kiválaszthat egyet.
A kiválasztott térképadatok kezelése
-
Az onSelect visszahívásban érje el a result.data értéket.
Ez tartalmazza a térképadatokat a kért formátumban. -
(Opcionális) Használja a további visszaadott mezőket:
- result.title — a térkép címe
- result.mapCode — a Scribble Maps térképkódja
- result.thumbUrl — a térkép miniatűrjének URL-je
-
Adja át az adatokat az alkalmazása logikájának.
Például töltse be a visszaadott GeoJSON-t a saját térképmegjelenítőjébe vagy adatfeldolgozási folyamatába.
Opcionális konfiguráció
A választót az alkalmazása munkafolyamatához jobban illeszkedően is beállíthatja.
-
Az exportálási formátum kiválasztásához módosítsa a format értékét.
Például: geojson, kml, csv, gpx, dxf, shapefile vagy smjson. -
Válassza ki, mely térképforrásokat böngészhetik a felhasználók a tabs beállítással.
A felhasználók böngészhetnek a személyes könyvtárukban, a csapatok által megosztott térképek között vagy a közösségi gyűjteményben található térképek között. - (Opcionális) Használja a mellékelt gombstílusokat, hogy illeszkedjen egy világos vagy sötét felülethez.
Támogatott formátumok és visszaadott mezők
Támogatott exportálási formátumok:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Visszaadott eredménymezők:
- data
- title
- mapCode
- thumbUrl
Egyszeri beállítás után a Connect Picker egyetlen integrációs ponton keresztül biztosít hozzáférést a felhasználóinak a Scribble Maps adataihoz közvetlenül az Ön alkalmazásán belülről.
Kapcsolódó
Utoljára frissítve