Pridėkite ScribbleMaps į savo programą
Pastaba:Naudokite ScribbleMaps Connect Picker, kai norite, kad naudotojai prisijungtų prie Scribble Maps, naršytų savo turimus žemėlapius ir grąžintų žemėlapio duomenis tiesiai į jūsų žiniatinklio programą.Parinkiklis atsidaro iššokančiame lange ir ten atlieka naudotojo prisijungimo procesą, todėl jūsų programai nereikia tiesiogiai rinkti Scribble Maps prisijungimo duomenų.
Turinys
Gaukite savo Client ID
Pridėkite SDK prie savo puslapio
Atidarykite Connect Picker
Apdorokite pasirinktus žemėlapio duomenis
Pasirenkama konfigūracija
Palaikomi formatai ir grąžinami laukai
Kaip veikia Connect Picker
ScribbleMaps Connect Picker leidžia jūsų naudotojams naršyti, ieškoti ir pasirinkti žemėlapius iš Scribble Maps, o tada grąžinti tuos žemėlapio duomenis tiesiai į jūsų programą jūsų pasirinktu formatu.
Tai naudinga, kai norite, kad naudotojai kurtų ar tvarkytų geoduomenis Scribble Maps, o tada įkeltų tuos duomenis į jūsų programą, nekurdami savo žemėlapių naršyklės ar prisijungimo eigos.
Naudojimo atvejis / Pavyzdys:
Ši integracija naudinga prietaisų skydeliams, nekilnojamojo turto įrankiams, lauko duomenų programoms ir kitoms žiniatinklio programoms, kurioms reikia, kad naudotojai pasirinktų ir įkeltų pažymėtus duomenis iš Scribble Maps.
Gaukite savo Client ID
-
Atidarykite Scribble Maps kūrėjų svetainę:
https://developers.scribblemaps.com -
Užregistruokite nemokamą projektą.
-
Nukopijuokite savo Client ID.
Šią reikšmę naudosite kviesdami Connect Picker.
Pridėkite SDK prie savo puslapio
-
Savo žiniatinklio puslapyje pridėkite Connect Picker SDK:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Įrašykite savo puslapio pakeitimus.
Scribble Maps Connect Picker dabar pasiekiamas jūsų programai.
Atidarykite Connect Picker
-
Iškvieskite ScribbleMapsConnect.pick() iš savo puslapio.
-
Perduokite savo clientId, norimą eksporto format ir onSelect atgalinį iškvietimą.
-
Naudokite kodą, panašų į šį pavyzdį:
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); } });Kai parinkiklis atsidaro, naudotojas gali autentifikuotis, naršyti savo turimus žemėlapius ir vieną pasirinkti.
Apdorokite pasirinktus žemėlapio duomenis
-
onSelect atgaliniame iškvietime pasiekite result.data.
Tai yra žemėlapio duomenys jūsų pasirinktu formatu. -
(Neprivaloma) Naudokite papildomus grąžinamus laukus:
- result.title — žemėlapio pavadinimas
- result.mapCode — Scribble Maps žemėlapio kodas
- result.thumbUrl — žemėlapio miniatiūros URL
-
Perduokite duomenis į savo programos logiką.
Pavyzdžiui, įkelkite grąžintą GeoJSON į savo žemėlapių peržiūros įrankį ar duomenų darbo eigą.
Pasirenkama konfigūracija
Galite sukonfigūruoti parinkiklį, kad jis geriau atitiktų jūsų programos darbo eigą.
-
Pasirinkite eksporto formatą pakeisdami format reikšmę.
Pavyzdžiui: geojson, kml, csv, gpx, dxf, shapefile arba smjson. -
Pasirinkite, kuriuos žemėlapių šaltinius naudotojai gali naršyti, naudodami tabs parinktį.
Naudotojai gali naršyti žemėlapius iš savo asmeninės bibliotekos, komandos bendrinamų žemėlapių arba bendruomenės kolekcijos. - (Neprivaloma) Naudokite pridėtus mygtukų stilius, kad jie atitiktų šviesią arba tamsią sąsają.
Palaikomi formatai ir grąžinami laukai
Palaikomi eksporto formatai:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Grąžinami rezultato laukai:
- data
- title
- mapCode
- thumbUrl
Vieną kartą sukonfigūravus, Connect Picker suteikia jūsų naudotojams prieigą prie jų Scribble Maps duomenų tiesiai jūsų programoje per vieną integracijos tašką.
Susiję
Paskutinį kartą atnaujinta