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

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

يمكنك تخصيص الخطوط المتعددة للمسار باستخدام الطريقة ConsumerMapStyle.setPolylineStyleOptions. في حال ضبط خيارات مخصّصة لخطوط الالتفاف، ستلغي هذه الخيارات القيم التلقائية التي تقدّمها حزمة Consumer 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)