سفارشی کردن چند خطوط مسیر

شما چند خطوط مسیر را با استفاده از روش ConsumerMapStyle.setPolylineStyleOptions سفارشی می کنید. اگر گزینه های چند خط سفارشی را تنظیم کنید، آنها مقادیر پیش فرض ارائه شده توسط Consumer SDK را لغو می کنند.

برای بازیابی مقادیر پیش‌فرض ، 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);

// 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);

// 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 برای Polyline مراجعه کنید.

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

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

مثال

// TrafficStyle is part of the Consumer SDK.
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

// TrafficStyle is part of the Consumer SDK.
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
    .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)