تخصيص الخطوط المتعددة للمسار

اختيار النظام الأساسي: نظام التشغيل Android iOS JavaScript

يمكنك تخصيص الخطوط المتعددة للمسار باستخدام طريقة ConsumerMapStyle.setPolylineStyleOptions. في حال ضبط خطوط متعدّدة مخصّصة ستلغي القيم التلقائية التي تقدّمها حزمة تطوير البرامج (SDK) الخاصة بالمستهلك.

لاستعادة القيم التلقائية، اتصل setPolylineStyleOptions مع null للمعلمة PolylineOptions.

لاسترداد قيمة PolylineOptions النشطة، استخدِم getPolylineStyleOptions.

لمزيد من المعلومات، يُرجى مراجعة ConsumerMapStyle.setPolylineStyleOptions

أنواع الخطوط المتعددة للمسار

يمكنك تخصيص أنواع الخطوط المتعددة للمسارات التالية:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

يتم عرض ACTIVE_ROUTE وREMAINING_ROUTE أثناء مشاركة الرحلة مسار المركبة.

خصائص الخطوط المتعددة للمسار

توفّر "خرائط Google" خصائص قابلة للتخصيص متاحة لكل خط متعدد في PolylineOptions

  • لإنشاء PolylineOptions، استخدِم الدالة الإنشائية الخاصة به.

  • لتحديد السمات المخصّصة، استخدِم "Setter" (أداة الإعداد). والأسلوب. منذ توفر الطريقة القيم الافتراضية لكل خاصية، فأنت بحاجة فقط لتحديد أي قيم مخصصة.

  • لإيقاف الخطوط المتعددة، اضبط visible على false.

لمزيد من التفاصيل، يُرجى مراجعة PolylineOptions في مستندات مطوّري برامج Android

مثال

Java

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

المسار نشط والمتبقي

عند تفعيل ميزة مشاركة الرحلة، يمكن لتطبيقك تخصيص تجربت ا المستخدم باستخدام الخطوط المتعددة لعرض المسار النشط والمتبقّي لمركبتك.

  • المسار النشط هو المسار الذي تسلكه المركبة الآن للوصول إليه النقطة التالية في رحلة المستهلك النشطة.

  • المسار المتبقي هو المسار الذي لا يزال يتعين على المركبة مروره المسار النشط. فعندما تكون نقطة طريق المسار النشطة هي آخر نقطة طريق للرحلة، المسار المتبقي غير موجود.

يمكنك تخصيص إذن الوصول إلى الخطوط المتعددة النشطة وتلك المتبقية والتحكّم فيها في تطبيقك. يكون المسار النشط مرئيًا والمسار المتبقي تلقائيًا. غير مرئية.

مثال

Java

// 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 حول Polyline.

تمثل خرائط Google أحوال حركة المرور كإحدى أربعة أنواع للسرعة. يمكنك تخصيص لون كل نوع سرعة.

لتفعيل الخطوط المتعددة الواعية بحركة المرور، أنشئ كائن TrafficStyle. ثم مرِّره إلى ConsumerMapStyle من خلال الاتصال برقم setPolylineTrafficStyle().

مثال

Java

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

Kotlin

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