Android SDK Resources
نسخه 1.1
هدف از این بخش از پروژه بررسی نحوه فعالسازی و غیرفعالسازی خوشه بندی (Clustering) نشانگرهاست. خوشه بندی زمانی کاربرد دارد که تعداد نشانگرهای موجود بر روی نقشه زیاد باشد و برای جلوگیری از شلوغی نقشه با تکنیک خوشه بندی، نشانگرهای نزدیک به هم را با هم ادغام می کنیم و در صورتی که زوم نقشه بر روی نشانگرها باشد آن ها را از حالت ادغام خارج میکنیم. این کار براحتی در sdk نقشه نشان بطور خودکار انجام می شود که نحوه فعال یا غیرفعالسازی آن را در ادامه توضیح می دهیم.
سپس در فایل Main پروژه در قسمت Region Project Attributes خط زیر را اضافه کنید:
#AdditionalJar: common-release.aar
activity_clustering.bal
در Visual designer زیر که مربوط به Layout اکتیویتی خوشه بندی نشانگرها است، یک View ی نقشه و یک Toggle button وجود دارد که پس از کلیک روی آن در صورت فعال بودن دکمه، نشانگرهای روی نقشه خوشه بندی میشوند و در صورت خاموش بودن دکمه، نشانگرها از حالت خوشه بندی خارج میشود.
جهت تعریف شیء نقشه در کد روی View ی مربوط به نقشه که نام آن در این مثال NeshanMapSdk1 است راست کلیک کرده و از منوی باز شونده Generate، گزینه Dim NeshanMapSdk1 as NeshanMapSdk را انتخاب میکنیم. پس از این عمل، شیء نقشه در فایل کد مربوط به اکتیویتی خوشه بندی نشانگرها (ClusteringActivity) در قسمت Globals اضافه میشود.
Sub Globals
'These global variables will be redeclared each time the activity is created.
'These variables can only be accessed from this module.
Private NeshanMapSdk1 As NeshanMapSdk
End Sub
جهت ایجاد Event مربوط به ToggleButton، به Visual Designer مربوط به اکتیویتی ClusteringActivity رفته و روی ToggleButton راست کلیک کنید و از منوی باز شونده Generate گزینه CheckedChange را انتخاب کنید تا Event مربوط به تغییر مقدار ToggleButton به اکتیویتی اضافه شود.
Private Sub ToggleClusteringButton_CheckedChange(Checked As Boolean)
End Sub
افزودن نشانگر با قابلیت خوشه بندی
برای افزودن نشانگر با قابلیت خوشه بندی باید از متد addClusteringMarker به صورت زیر استفاده کنید. در صورتی که میخواهید نشانگری خوشه بندی نشود، از متد addMarker که در صفحه افزودن نشانگر توضیح داده شده است، استفاده نمایید.
NeshanMapSdk1.addClusteringMarker(clusteringMarkerDrawable,markerSize,Latitude,Longitude)
فعالسازی خوشه بندی نشانگرها
جهت فعال و غیرفعال سازی خوشه بندی نشانگرها، میتوانید از متغیر ClusteringEnabled که از نوع Boolean است استفاده نمایید.
NeshanMapSdk1.ClusteringEnabled = True
مقدار متغیر ClusteringEnabled در صورتی که True باشد نشانگرها خوشه بندی خواهند شد و در صورتی که False باشد نشانگرها از حالت خوشه بندی خارج خواهند شد.
Private Sub ToggleClusteringButton_CheckedChange(Checked As Boolean)
NeshanMapSdk1.ClusteringEnabled = Checked
End Sub
نسخه 1.0
هدف از این بخش از پروژه بررسی نحوه فعالسازی و غیرفعالسازی خوشه بندی (Clustering) نشانگرهاست. خوشه بندی زمانی کاربرد دارد که تعداد نشانگرهای موجود بر روی نقشه زیاد باشد و برای جلوگیری از شلوغی نقشه با تکنیک خوشه بندی، نشانگرهای نزدیک به هم را با هم ادغام می کنیم و در صورتی که زوم نقشه بر روی نشانگرها باشد آن ها را از حالت ادغام خارج میکنیم. این کار براحتی در sdk نقشه نشان بطور خودکار انجام می شود که نحوه فعال یا غیرفعالسازی آن را در ادامه توضیح می دهیم.
سپس در فایل Main پروژه در قسمت Region Project Attributes خط زیر را اضافه کنید:
#AdditionalJar: common-release.aar
activity_clustering.bal
در Visual designer زیر که مربوط به Layout اکتیویتی خوشه بندی نشانگرها است، یک View ی نقشه و یک Toggle button وجود دارد که پس از کلیک روی آن در صورت فعال بودن دکمه، نشانگرهای روی نقشه خوشه بندی میشوند و در صورت خاموش بودن دکمه، نشانگرها از حالت خوشه بندی خارج میشود.
جهت تعریف شیء نقشه در کد روی View ی مربوط به نقشه که نام آن در این مثال NeshanMapSdk1 است راست کلیک کرده و از منوی باز شونده Generate، گزینه Dim NeshanMapSdk1 as NeshanMapSdk را انتخاب میکنیم. پس از این عمل، شیء نقشه در فایل کد مربوط به اکتیویتی خوشه بندی نشانگرها (ClusteringActivity) در قسمت Globals اضافه میشود.
Sub Globals
'These global variables will be redeclared each time the activity is created.
'These variables can only be accessed from this module.
Private NeshanMapSdk1 As NeshanMapSdk
End Sub
جهت ایجاد Event مربوط به ToggleButton، به Visual Designer مربوط به اکتیویتی ClusteringActivity رفته و روی ToggleButton راست کلیک کنید و از منوی باز شونده Generate گزینه CheckedChange را انتخاب کنید تا Event مربوط به تغییر مقدار ToggleButton به اکتیویتی اضافه شود.
Private Sub ToggleClusteringButton_CheckedChange(Checked As Boolean)
End Sub
افزودن نشانگر با قابلیت خوشه بندی
برای افزودن نشانگر با قابلیت خوشه بندی باید از متد addClusteringMarker به صورت زیر استفاده کنید. در صورتی که میخواهید نشانگری خوشه بندی نشود، از متد addMarker که در صفحه افزودن نشانگر توضیح داده شده است، استفاده نمایید.
NeshanMapSdk1.addClusteringMarker(clusteringMarkerDrawable,markerSize,Latitude,Longitude)
فعالسازی خوشه بندی نشانگرها
جهت فعال و غیرفعال سازی خوشه بندی نشانگرها، میتوانید از متغیر ClusteringEnabled که از نوع Boolean است استفاده نمایید.
NeshanMapSdk1.ClusteringEnabled = True
مقدار متغیر ClusteringEnabled در صورتی که True باشد نشانگرها خوشه بندی خواهند شد و در صورتی که False باشد نشانگرها از حالت خوشه بندی خارج خواهند شد.
Private Sub ToggleClusteringButton_CheckedChange(Checked As Boolean)
NeshanMapSdk1.ClusteringEnabled = Checked
End Sub
