نشانگرها را سفارشی کنید

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS، جاوا اسکریپت

کلاس ConsumerMapStyle متدهای setter و getter را با قابلیت سفارشی‌سازی پویا برای نشانگرها و چندخطی‌ها ارائه می‌دهد. شما می‌توانید این کلاس را به صورت غیرهمزمان با استفاده از متد ConsumerController.getConsumerMapStyle() نمایش دهید.

سفارشی‌سازی رابط کاربری در طول چرخش دستگاه ادامه می‌یابد و تا زمانی که ConsumerController را جدا نکنید، در اثر خود باقی می‌ماند.

نشانگرها را سفارشی کنید

برای تنظیم نوع نشانگر و ویژگی‌های آن، از متد ConsumerMapStyle.setMarkerStyleOptions() استفاده کنید. گزینه‌های نشانگر سفارشی شما، مقادیر پیش‌فرض ارائه شده توسط Consumer SDK را لغو می‌کنند. برای بازیابی مقادیر پیش‌فرض، setMarkerStyleOptions() با استفاده از null برای پارامتر MarkerOptions فراخوانی کنید. MarkerOptions فعال را با استفاده از getMarkerStyleOptions() بازیابی کنید.

نوع نشانگر را انتخاب کنید

می‌توانید از نمادهای نشانگر زیر استفاده کرده و آنها را سفارشی کنید:

  • TRIP_PICKUP_POINT - هنگام دنبال کردن یک سفر نمایش داده می‌شود
  • TRIP_DROPOFF_POINT - هنگام دنبال کردن یک سفر نمایش داده می‌شود
  • TRIP_INTERMEDIATE_DESTINATION

  • TRIP_VEHICLE - هنگام دنبال کردن یک سفر نمایش داده می‌شود

    کیت توسعه نرم‌افزار مصرف‌کننده (Consumer SDK) چرخش آیکون TRIP_VEHICLE را در طول نظارت بر سفر به‌روزرسانی می‌کند تا رفتار وسیله نقلیه واقعی را هنگام طی مسیر تقلید کند.

گزینه‌های نشانگر را انتخاب کنید

با دنبال کردن این مراحل می‌توانید نشانگرها را برای برنامه مصرف‌کننده خود سفارشی کنید:

  1. از ویژگی‌های هر نشانگر ارائه شده توسط Google Maps MarkerOptions استفاده کنید.

  2. با استفاده از سازنده‌ی MarkerOptions آن را بسازید.

  3. با استفاده از متدهای سبک «Setter»، ویژگی‌های سفارشی را مشخص کنید.

  4. اگر ترجیح می‌دهید، با تقلید از الگوهای ارائه شده توسط سازنده MarkerOptions از عنصر رابط کاربری خودتان استفاده کنید.

  5. برای خاموش کردن یک نشانگر، ویژگی visible را روی false تنظیم کنید. سپس می‌توانید از عنصر رابط کاربری خودتان به جای آن استفاده کنید.

برای اطلاعات بیشتر، به MarkerOptions نقشه های گوگل مراجعه کنید.

نمونه سفارشی‌سازی‌های نشانگر

جاوا 

// Initializing marker options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setMarkerStyleOptions(
              MarkerType.TRIP_VEHICLE,
              new MarkerOptions()
                  .visible(false));
        });

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null);

کاتلین 

// Initializing marker options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, MarkerOptions().visible(false))
  })

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null)

قدم بعدی چیست؟