Tambah ScribbleMaps ke Aplikasi Anda
Nota:Gunakan ScribbleMaps Connect Picker apabila anda mahu pengguna log masuk ke Scribble Maps, melayari peta yang tersedia bagi mereka, dan memulangkan data peta terus ke aplikasi web anda.Pemilih dibuka dalam tetingkap timbul dan mengendalikan proses log masuk pengguna di sana, supaya aplikasi anda tidak perlu mengumpul bukti kelayakan Scribble Maps secara langsung.
Kandungan
Dapatkan Client ID anda
Tambah SDK ke halaman anda
Buka Connect Picker
Kendalikan data peta yang dipilih
Konfigurasi pilihan
Format yang disokong dan medan yang dipulangkan
Cara Connect Picker berfungsi
ScribbleMaps Connect Picker membolehkan pengguna anda melayari, mencari dan memilih peta daripada Scribble Maps, kemudian memulangkan data peta tersebut terus ke aplikasi anda dalam format yang anda pilih.
Ini berguna apabila anda mahu pengguna mencipta atau mengurus geodata dalam Scribble Maps dan kemudian memuatkan data tersebut ke dalam aplikasi anda sendiri tanpa perlu membina pelayar peta atau aliran log masuk anda sendiri.
Kes Penggunaan / Contoh:
Integrasi ini berguna untuk papan pemuka, alat hartanah, aplikasi data lapangan, dan aplikasi web lain yang memerlukan pengguna memilih dan memuatkan data berpeta daripada Scribble Maps.
Dapatkan Client ID anda
-
Buka laman pembangun Scribble Maps:
https://developers.scribblemaps.com -
Daftar projek percuma.
-
Salin Client ID anda.
Anda akan menggunakan nilai ini apabila memanggil Connect Picker.
Tambah SDK ke halaman anda
-
Dalam halaman web anda, Tambah SDK Connect Picker:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Simpan perubahan halaman anda.
Scribble Maps Connect Picker kini tersedia untuk aplikasi anda.
Buka Connect Picker
-
Panggil ScribbleMapsConnect.pick() daripada halaman anda.
-
Hantar clientId anda, format eksport yang anda mahu, dan panggil balik onSelect.
-
Gunakan kod yang serupa dengan contoh berikut:
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); } });Apabila pemilih dibuka, pengguna boleh mengesahkan identiti, melayari peta yang tersedia bagi mereka, dan memilih satu.
Kendalikan data peta yang dipilih
-
Dalam panggil balik onSelect, akses result.data.
Ini mengandungi data peta dalam format yang anda minta. -
(Pilihan) Gunakan medan tambahan yang dipulangkan:
- result.title — tajuk peta
- result.mapCode — kod peta Scribble Maps
- result.thumbUrl — URL imej kecil bagi peta
-
Hantar data ke dalam logik aplikasi anda.
Sebagai contoh, muatkan GeoJSON yang dipulangkan ke dalam pelihat peta atau aliran kerja data anda sendiri.
Konfigurasi pilihan
Anda boleh mengkonfigurasi pemilih agar lebih sesuai dengan aliran kerja aplikasi anda.
-
Pilih format eksport dengan menukar nilai format.
Contohnya: geojson, kml, csv, gpx, dxf, shapefile, atau smjson. -
Pilih sumber peta yang boleh dilayari pengguna dengan pilihan tabs.
Pengguna boleh melayari peta daripada pustaka peribadi mereka, peta yang dikongsi pasukan, atau koleksi komuniti. - (Pilihan) Gunakan gaya butang yang disertakan agar sepadan dengan antara muka cerah atau gelap.
Format yang disokong dan medan yang dipulangkan
Format eksport yang disokong:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Medan hasil yang dipulangkan:
- data
- title
- mapCode
- thumbUrl
Sekali dikonfigurasi, Connect Picker memberi pengguna anda akses kepada data Scribble Maps mereka terus dari dalam aplikasi anda melalui satu titik integrasi.
Berkaitan
Import/Eksport Fail & Data - GeoJSON, imej, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, dll.
Dikemas kini pada