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

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

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

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

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

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

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

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

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

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

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

نقشه‌های گوگل ویژگی‌های قابل تنظیمی را برای هر چندخطی در PolylineOptions ارائه می‌دهند.

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

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

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

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

مثال

جاوا

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

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

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

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

برای فعال کردن چندخطی‌های آگاه از ترافیک ، یک شیء 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);

کاتلین

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