مستندات جامع اندروید
نسخه 1.0.3
هدف از این بخش از پروژه بررسی نحوه فعالسازی و غیرفعالسازی خوشه بندی ( Clustering ) نشانه هاست. خوشه بندی زمانی کاربرد دارد که تعداد نشانه های موجود بر روی نقشه زیاد باشد و برای جلوگیری از شلوغی نقشه با تکنیک خوشه بندی، نشانه های نزدیک به هم را با هم ادغام می کنیم و در صورتی که زوم نقشه بر روی نشانه ها باشد آن ها را از حالت ادغام خارج میکنیم. این کار براحتی در sdk نقشه نشان بطور خودکار انجام می شود که نحوه فعال یا غیرفعالسازی آن را در ادامه توضیح می دهیم.
activity_marker_clustering.xml
:
در این صفحه، علاوه بر المان نقشه نشان، یک ToggleButton
برای فعال یا غیرفعال کردن خوشه بندی وجود دارد.
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
xmlns:app="http://schemas.android.com/apk/res-auto"
tools:context=".activity.MarkerClustering">
<org.neshan.mapsdk.MapView
android:layout_width="0dp"
android:layout_height="0dp"
android:id="@+id/map"
app:layout_constraintTop_toTopOf="parent"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintEnd_toEndOf="parent"/>
<ToggleButton
android:checked="true"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textColor="@color/toggle_button_text_color"
android:textOff="خوشه بندی"
android:textOn="خوشه بندی"
android:elevation="8dp"
android:paddingStart="8dp"
android:paddingEnd="8dp"
android:background="@drawable/toggle_button_bg"
android:layout_marginBottom="8dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintEnd_toEndOf="parent"
tools:targetApi="m"
android:onClick="toggleClustering"/>
</androidx.constraintlayout.widget.ConstraintLayout>
MarkerClustering.java
:
متد initLayoutRefrences
جهت مقداردهی اولیه تمامی المانهای مربوط به رابط کاربری نوشته شدهاست. به دلیل این که لازم است تا المان اندرویدی نقشه نشان ابتدا به طور کامل ایجاد شود و سپس با آن تعامل برقرار شود (متدهای مختلف بر روی المان نقشه اجرا شود)، تمامی متدهای مربوط به رابط کاربری باید در متد onStart
انجام شوند.
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// starting app in full screen
requestWindowFeature(Window.FEATURE_NO_TITLE);
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN);
setContentView(R.layout.activity_marker_clustering);
}
@Override
protected void onStart() {
super.onStart();
// everything related to ui is initialized here
initLayoutReferences();
}
پس از مقداردهی اولیه viewها یک رویداد کلیک ( OnMapClickListener
) بر روی نقشه تعریف می شود تا با هر کلیک بر روی نقشه یک نشانه جدید اضافه شود. نشانه جدید با کمک متد createMarker
ساخته شده و با map.addMarker
به نقشه اضافه می شود.
توضیحات نحوه ایجاد نشانه را می توانید در بخش اضافه کردن نشانگر ببینید.
اینجا یک پارامتر دیگر به متد createMarker
افزوده شده که در صورت false
بودن نشانگر قرمز و در صورت true
نشانگر آبی رنگ ایجاد می شود. پس با هر بار کلیک بر روی نقشه یک نشانگر قرمز به نقشه اضافه می شود. همچنین یک رویداد لمس طولانی ( setOnMapLongClickListener
) بر روی نقشه تعریف می شود که مشابه رویداد کلیک یک نشانگر به نقشه اضافه میکند، با این تفاوت که نشانگر افزوده شده آبی رنگ است و همچنین متد map.addMarker
در اینجا با یک پارامتر false
برای ورودی clusterable
صدا زده می شود. این کار باعث میشود نشانگرهای اضافه شده به این شکل شامل خوشه بندی ( clustering ) نشوند. و در آخر یک رویداد setOnMarkerClickListener
برای نقشه تعریف شده که با کلیک بر روی هر نشانگر صدا زده می شود و با استفاده از متد map.removeMarker
نشانگر مربوطه را از روی نقشه حذف می کند.
// Initializing layout references (views, map and map events)
private void initLayoutReferences() {
// Initializing views
initViews();
// when clicked on map, a marker is added in clicked location
map.setOnMapClickListener(latLng -> {
map.addMarker(createMarker(latLng,false));
});
// when clicked on map, a marker is added in clicked location
map.setOnMapLongClickListener(latLng -> {
map.addMarker(createMarker(latLng,true),false);
});
map.setOnMarkerClickListener(marker -> map.removeMarker(marker));
}
متد toggleClustering که با هر بار کلیک بر روی toggleButton
صدا زده می شود، بررسی می کند که اگر toggleButton
موجود در رابط کاربری در حالت انتخاب شده باشد، خوشه بندی نشانه ها با استفاده از متد map.getSettings().setMarkerClusteringEnabled(true)
فعال می شود و در غیر اینصورت این متد با مقدار false
فراخوانی شده و در نتیجه خوشه بندی غیرفعال می شود.
public void toggleClustering(View view) {
ToggleButton toggleButton = (ToggleButton) view;
isClusteringEnable = !isClusteringnable;
if (toggleButton.isChecked())
map.getSettings().setMarkerClusteringEnabled(true)
else
map.getSettings().setMarkerClusteringEnabled(false)
}