سفارشی‌سازی چندخطی‌های مسیر

پلاتفرم را انتخاب کنید: Android iOS JavaScript

چندخطی‌های مسیر را بااستفاده از روش ConsumerMapStyle.setPolylineStyleOptions سفارشی‌سازی می‌کنید. اگر گزینه‌های چندخطی سفارشی تنظیم کنید، این گزینه‌ها مقادیر پیش‌فرض ارائه‌شده توسط «کیت توسعه نرم‌افزار مصرف‌کننده» را لغو می‌کنند.

برای بازیابی مقادیر پیش‌فرض، setPolylineStyleOptions را با null برای پارامتر PolylineOptions فراخوانی کنید.

برای بازیابی PolylineOptions فعال، از روش getPolylineStyleOptions استفاده کنید.

برای اطلاعات بیشتر، به ConsumerMapStyle.setPolylineStyleOptions مراجعه کنید.

انواع چندخطی مسیر

می‌توانید انواع چندخطی مسیر زیر را سفارشی‌سازی کنید:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE و REMAINING_ROUTE هنگام دنبال کردن سفر نمایش داده می‌شوند و مسیر خودرو را نشان می‌دهند.

ویژگی‌های چندخطی مسیر

‫Google Maps ویژگی‌های قابل‌سفارشی‌سازی را برای هر چندخطی در PolylineOptions ارائه می‌دهد.

  • برای ساختن PolylineOptions، از سازنده آن استفاده کنید.

  • برای مشخص کردن ویژگی‌های سفارشی‌شده، از روش‌های سبک «Setter» استفاده کنید. ازآنجایی‌که این روش مقادیر پیش‌فرضی را برای هر ویژگی ارائه می‌دهد، فقط باید مقادیر سفارشی را مشخص کنید.

  • برای خاموش کردن چندخطی، visible را روی false تنظیم کنید.

برای جزئیات بیشتر، PolylineOptions را در اسناد توسعه‌دهنده Android ببینید.

مثال

جاوا

// Initializing polyline style options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .visible(false));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);

Kotlin

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setPolylineStyleOptions(
      PolylineType.ACTIVE_ROUTE,
      PolylineOptions().visible(false)
    )
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

مسیر فعال و باقی‌مانده

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

  • مسیر فعال مسیری است که خودرو درحال‌حاضر برای رسیدن به نقطه‌مسیر بعدی در سفر فعال مصرف‌کننده طی می‌کند.

  • مسیر باقی‌مانده مسیری است که خودرو هنوز باید پس‌از مسیر فعال طی کند. وقتی نقطه‌مسیر فعال آخرین نقطه‌مسیر سفر باشد، مسیر باقی‌مانده وجود ندارد.

می‌توانید نمایان بودن چندخطی‌های فعال و باقی‌مانده را در برنامه‌تان سفارشی‌سازی و کنترل کنید. به‌طور پیش‌فرض، مسیر فعال نمایان است و مسیر باقی‌مانده نمایان نیست.

مثال

جاوا

// Initializing polyline options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .color(Color.BLUE));
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.REMAINING_ROUTE,
              new PolylineOptions()
                  .color(Color.BLACK)
                  .width(5)
                  .visible(true));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);
consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null);

Kotlin

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    {
      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.ACTIVE_ROUTE,
        PolylineOptions().color(Color.BLUE)
      )

      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.REMAINING_ROUTE,
        PolylineOptions().color(Color.BLACK).width(5).visible(true)
      )
    }
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null)

چندخطی‌های آگاه از ترافیک

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

Google Maps وضعیت ترافیک را به‌عنوان یکی از چهار نوع سرعت نشان می‌دهد. می‌توانید رنگ را برای هر نوع سرعت سفارشی‌سازی کنید.

برای فعال کردن چندخطی‌های آگاه از ترافیک، یک شیء TrafficStyle بسازید و سپس آن را با فراخوانی setPolylineTrafficStyle() به ConsumerMapStyle ارسال کنید.

مثال

جاوا

// TrafficStyle is part of the Consumer SDK.
int orange = Color.rgb(255, 165, 0);
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW, orange)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

Kotlin

// TrafficStyle is part of the Consumer SDK.
val orange = Color.rgb(255, 165, 0)
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GRAY)
    .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW, orange)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)