مستندات جامع اندروید
نسخه 1.0.3
هدف این بخش از پروژه، رسم یک چندضلعی بر روی نقشه است. مانند بخشهای قبل، بخشهایی که در کدهای قبلی نیز موجود است دوباره توضیح داده نشده است.
فهرست مطالب این صفحه
- activity_draw_polygon.xml
:
یک دکمه به این صفحه اضافه شده است که در صورت فشار داده شدن، متد drawPolygon
صدا زده میشود و یک چندضلعی از پیش تعریف شده بر روی نقشه نمایش داده میشود.
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".activity.DrawPolygon">
<org.neshan.mapsdk.MapView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/map"/>
<Button
android:onClick="drawPolygon"
android:id="@+id/draw_polygon"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:paddingStart="8dp"
android:paddingEnd="8dp"
android:text="رسم چندضلعی"
android:textColor="#ffffff"
android:elevation="8dp"
android:background="@drawable/toggle_button_on_bg"
android:layout_marginBottom="8dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
tools:targetApi="m" />
</androidx.constraintlayout.widget.ConstraintLayout>
DrawPolygon.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_draw_polygon);
}
@Override
protected void onStart() {
super.onStart();
// everything related to ui is initialized here
initLayoutReferences();
}
متد drawPolygon
یک چندضلعی از پیش تعریف شده را بر روی نقشه نمایش میدهد.
به این منظور ابتدا اگر متغیر polygon
از قبل حاوی شی باشد ( null نباشد )، آن شکل را با استفاده از متد removePolygon
از روی نقشه حذف میکند. سپس یک <ArrayList<LatLng
– که لیستی از نقاط جغرافیایی است – ساخته میشود و چهار نقطه (راسهای چندضلعی) به این لیست اضافه میشود.
با استفاده از لیست نقاط ساخته شده و استایلی که از متد getPolygonStyle
( که در ادامه توضیح داده خواهد شد) گرفته می شود یک چندضلعی یا Polylgon
ساخته میشود.
چندضلعی ساخته شده با استفاده از متد addPolygon
به map
اضافه میشود که با این کار، چندضلعی بر روی نقشه نشان داده خواهد شد.
در نهایت دوربین بر روی اولین نقطه چندضلعی متمرکز می شود. بزرگنمایی دوربین برابر با ۱۴ است.
public void drawPolygon(View view){
//remove polyline from map if exist
if(polygon!=null){
map.removePolygon(polygon);
}
// Adding some LatLng points to a latLngs
ArrayList<LatLng> latLngs = new ArrayList<>();
latLngs.add(new LatLng(35.762294,51.325525));
latLngs.add(new LatLng(35.756548,51.323768));
latLngs.add(new LatLng(35.755394,51.328617));
latLngs.add(new LatLng(35.760905,51.330666));
// Creating a polygon from list of latlngs. here we use getPolygonStyle() method to define polygon styles
polygon = new Polygon(latLngs, getPolygonStyle());
// adding the created polygon on map
map.addPolygon(polygon);
// focusing camera on first point of drawn polygon
map.moveCamera(new LatLng(35.762294,51.325525),0.25f );
map.setZoom(14,0);
}
متد getPolygonStyle
استایل مورد نیاز برای چندضلعیهایی که قرار است رسم شوند را برمیگرداند. برای ایجاد style برای چندضلعیها، ابتدا یک شی از کلاس PolygonStyleBuilder
ساخته میشود. ویژگیهای چندضلعی بر روی این شی set میشوند. در اینجا تنها ویژگی، style خطوط تشکیل دهنده یک چند ضلعی است که با استفاده از متد getLineStyle
به دست میآیند. این متد در بخش رسم خط توضیح داده شده است.
private PolygonStyle getPolygonStyle(){
PolygonStyleBuilder polygonStCr = new PolygonStyleBuilder();
polygonStCr.setLineStyle(getLineStyle());
return polygonStCr.buildStyle();
}
حذف چند ضلعی
جهت حذف چندضلعی رسم شده روی نقشه میتوانید از متد removePolygon استفاده نمایید.
map.removePolygon(polygon);