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

اختيار النظام الأساسي: 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)