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

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

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

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

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

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

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

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

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

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

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

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

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

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

  • برای خاموش کردن چندخطی، 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)