استفاده از Maps SDK برای اندروید نسخه 3.1.0 بتا

نسخه 3.1.0 بتای Maps SDK برای Android یک پیاده‌سازی جدید با سطح API مشابه نسخه قبلی است (همه کلاس‌ها و روش‌ها یکسان باقی می‌مانند)، و برخی از ویژگی‌های جدید را می‌توانید امتحان کنید:

  • سفارشی سازی نقشه ها
  • مدیریت برخورد نشانگر
  • سفارشی سازی Polyline

این راهنما نحوه استفاده از ویژگی های جدید را به شما نشان می دهد.

سفارشی سازی نقشه ها (بتا)

طرح‌بندی نقشه‌های مبتنی بر ابر ابزارها و ویژگی‌های مختلفی را ارائه می‌دهد که به شما امکان می‌دهد آسان‌تر نحوه استایل‌دهی نقشه‌هایتان را سفارشی و مدیریت کنید. به‌جای اینکه با استفاده از Maps API و SDK نقشه‌تان را به صورت کد طراحی کنید، می‌توانید نقشه‌های خود را در Google Cloud Console مدیریت کرده و سبک دهید. برای اطلاعات بیشتر، نمای کلی سفارشی سازی نقشه Android را ببینید.

مدیریت برخورد نشانگر (بتا)

می‌توانید مشخص کنید که آیا نشانگرهای سفارشی باید برچسب‌های نقشه پایه پیش‌فرض را در هنگام برخورد لغو کنند یا خیر و اولویت نسبی را بین نشانگرهای سفارشی نشان دهند. برای اطلاعات بیشتر، به مدیریت برخورد نشانگر (اندروید) مراجعه کنید.

سفارشی سازی Polyline (بتا)

اکنون چندین راه جدید برای سفارشی کردن ظاهر پلی لاین ها وجود دارد:

  • چند خطوط چند رنگ، بخش های چند خط را به رنگ های مختلف تنظیم می کنند.
  • چند خطوط گرادیان با استفاده از گرادیان دو رنگ، چند خط را رنگ می کنند.
  • چند خطوط مهر شده با استفاده از بیت مپ های تکراری به چند خط استایل دهی می دهند.

ایجاد یک خط چند رنگی

با ایجاد اشیاء StyleSpan و افزودن آنها به PolylineOptions با استفاده از متدهای addSpan() یا addSpans() می توانید از spans برای رنگ آمیزی جداگانه بخش های یک polyline استفاده کنید. به طور پیش فرض، هر آیتم در آرایه رنگ بخش خط مربوطه را تعیین می کند. مثال زیر تنظیم رنگ های بخش را برای ایجاد یک چند خط با بخش های قرمز و سبز نشان می دهد:

کاتلین



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

جاوا


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

ایجاد یک چند خط گرادیان

شما می توانید با تعیین دو عدد صحیح 32 بیتی آلفا-قرمز-سبز-آبی (ARGB) یک گرادیان تعریف کنید تا رنگ های آغاز و پایان stroke را مشخص کنید. با فراخوانی PolylineOptions.addSpan() این ویژگی را روی شی گزینه های شکل تنظیم کنید. مثال زیر ایجاد یک پلی لاین گرادیان قرمز به زرد از باغ وحش پارک وودلند تا کرکلند، WA را نشان می دهد.

کاتلین



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

جاوا


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

ایجاد یک پلی لاین مهر شده

شما می توانید ظاهر یک polyline را به یک بافت بیت مپ تکراری تنظیم کنید. برای انجام این کار، یک StampStyle of TextureStyle ایجاد کنید، سپس با فراخوانی PolylineOptions.addSpan() این ویژگی را روی شی گزینه های شکل تنظیم کنید.

کاتلین



val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

جاوا


StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

کتابخانه ابزار سازگار با بتا را وارد کنید

اگر از کتابخانه ابزار Google Maps Android API استفاده می‌کنید، باید وابستگی‌های پروژه خود را نیز به‌روزرسانی کنید تا با انجام کارهای زیر نسخه موجود را با نسخه بتا جایگزین کنید:

  1. کتابخانه util سازگار با بتا را در فایل build.gradle خود وارد کنید:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. موارد زیر را از build.gradle خود حذف کنید تا کتابخانه ابزاری غیر سازگار با بتا حذف شود:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

نمونه ها را اجرا کنید

مخزن Google Samples در GitHub شامل برنامه های نمونه ای است که استفاده از نسخه 3.1.0 Beta Maps SDK را برای اندروید نشان می دهد.