استفاده از کیت توسعه نرم‌افزار Google Maps برای Android نسخه ۳.۱.۰ بتا

نسخه بتای ۳.۱.۰ از «کیت توسعه نرم‌افزار Google Maps برای Android» پیاده‌سازی جدیدی با همان سطح میانای برنامه‌سازی کاربردی نسخه قبلی است (همه کلاس‌ها و روش‌ها یکسان باقی می‌مانند) و چند ویژگی جدید برای امتحان کردن دارد:

  • سفارشی‌سازی Maps
  • مدیریت تصادم نشانگر
  • سفارشی‌سازی چندخطی

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

سفارشی‌سازی Maps (بتا)

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

اداره کردن برخورد نشانگر (نسخه بتا)

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

سفارشی‌سازی چندخطی (بتا)

اکنون چندین روش جدید برای سفارشی‌سازی کردن ظاهر چندخطی‌ها وجود دارد:

  • چندخطی‌های چندرنگ بخش‌های چندخطی را به رنگ‌های مختلف تنظیم می‌کنند.
  • چندخطی‌های گرادیان چندخطی را بااستفاده از گرادیان دو رنگ رنگ‌آمیزی می‌کنند.
  • چندخطی‌های مُهرشده چندخطی را بااستفاده از نقشه‌های بیتی تکرارشونده سبک‌بندی می‌کنند.

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

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

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

می‌توانید با مشخص کردن دو عدد صحیح ۳۲ بیتی آلفا-قرمز-سبز-آبی (ARGB) یک گرادیان تعریف کنید تا رنگ‌های شروع و پایان خط را مشخص کنید. این ویژگی را با فراخوانی PolylineOptions.addSpan() در شیء گزینه‌های شکل تنظیم کنید.

ایجاد چندخطی مُهرشده

می‌توانید ظاهر چندخطی را روی بافت نگاشت بیتی تکرارشونده تنظیم کنید. برای انجام این کار، StampStyle از TextureStyle ایجاد کنید، سپس این خصوصیت را با فراخوانی PolylineOptions.addSpan() در شیء گزینه‌های شکل تنظیم کنید.

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

اگر از کتابخانه کمکی 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'