ScribbleMaps'i Uygulamanıza Ekleyin
Not:Kullanıcıların Scribble Maps'te oturum açmasını, mevcut haritalarına göz atmasını ve harita verilerini doğrudan web uygulamanıza döndürmesini istediğinizde ScribbleMaps Connect Picker'ı kullanın.Seçici bir açılır pencerede açılır ve kullanıcı oturum açma işlemini orada gerçekleştirir, böylece uygulamanızın doğrudan Scribble Maps kimlik bilgilerini toplamasına gerek kalmaz.
İçindekiler
Client ID'nizi alın
SDK'yı sayfanıza ekleyin
Connect Picker'ı açın
Seçilen harita verilerini işleyin
İsteğe bağlı yapılandırma
Desteklenen formatlar ve döndürülen alanlar
Connect Picker nasıl çalışır
ScribbleMaps Connect Picker, kullanıcılarınızın Scribble Maps'teki haritalara göz atmasına, arama yapmasına ve seçmesine, ardından bu harita verilerini seçtiğiniz formatta doğrudan uygulamanıza döndürmesine olanak tanır.
Bu, kullanıcıların Scribble Maps'te coğrafi veriler oluşturmasını veya yönetmesini ve ardından kendi harita tarayıcınızı veya oturum açma akışınızı oluşturmadan bu verileri kendi uygulamanıza yüklemesini istediğinizde kullanışlıdır.
Kullanım Durumu / Örnek:
Bu entegrasyon; panolar, mülk araçları, saha verisi uygulamaları ve kullanıcıların Scribble Maps'ten eşlenmiş verileri seçip yüklemesini gerektiren diğer web uygulamaları için kullanışlıdır.
Client ID'nizi alın
-
Scribble Maps geliştirici sitesini açın:
https://developers.scribblemaps.com -
Ücretsiz bir proje kaydedin.
-
Client ID'nizi kopyalayın.
Connect Picker'ı çağırırken bu değeri kullanacaksınız.
SDK'yı sayfanıza ekleyin
-
Web sayfanıza Connect Picker SDK'sını ekleyin:
<script src="https://api.scribblemaps.com/connect/picker.js"></script>
-
Sayfa değişikliklerinizi kaydedin.
Scribble Maps Connect Picker artık uygulamanız için kullanılabilir durumdadır.
Connect Picker'ı açın
-
Sayfanızdan ScribbleMapsConnect.pick() işlevini çağırın.
-
clientId'nizi, istediğiniz dışa aktarma format'ını ve bir onSelect geri çağırma işlevini iletin.
-
Aşağıdaki örneğe benzer bir kod kullanın:
ScribbleMapsConnect.pick({ clientId: 'YOUR_CLIENT_ID', format: 'geojson', onSelect: function (result) { // result.data, GeoJSON verinizi içerir // result.title, result.mapCode, result.thumbUrl değerleri de mevcuttur loadIntoMyApp(result.data); } });Seçici açıldığında, kullanıcı kimlik doğrulaması yapabilir, mevcut haritalarına göz atabilir ve birini seçebilir.
Seçilen harita verilerini işleyin
-
onSelect geri çağırma işlevinde result.data değerine erişin.
Bu, talep ettiğiniz formatta harita verilerini içerir. -
(İsteğe bağlı) Döndürülen ek alanları kullanın:
- result.title — harita başlığı
- result.mapCode — Scribble Maps harita kodu
- result.thumbUrl — harita için bir küçük resim URL'si
-
Verileri uygulama mantığınıza aktarın.
Örneğin, döndürülen GeoJSON'u kendi harita görüntüleyicinize veya veri iş akışınıza yükleyin.
İsteğe bağlı yapılandırma
Seçiciyi, uygulama iş akışınıza daha iyi uyacak şekilde yapılandırabilirsiniz.
-
format değerini değiştirerek dışa aktarma formatını seçin.
Örneğin: geojson, kml, csv, gpx, dxf, shapefile veya smjson. -
tabs seçeneğiyle kullanıcıların hangi harita kaynaklarına göz atabileceğini seçin.
Kullanıcılar kişisel kitaplıklarındaki, ekiple paylaşılan haritalardaki veya topluluk koleksiyonundaki haritalara göz atabilirler. - (İsteğe bağlı) Açık (light) veya koyu (dark) bir arayüze uyması için sunulan düğme stillerini kullanın.
Desteklenen formatlar ve döndürülen alanlar
Desteklenen dışa aktarma formatları:
- GeoJSON
- KML
- CSV
- GPX
- DXF
- Shapefile
- SMJSON
Döndürülen sonuç alanları:
- data
- title
- mapCode
- thumbUrl
Yapılandırıldıktan sonra Connect Picker, kullanıcılarınıza tek bir entegrasyon noktası üzerinden doğrudan uygulamanızın içinden Scribble Maps verilerine erişim sağlar.
İlgili
Son güncelleme