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

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

مثال

جافا

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

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

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

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

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

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

مثال

جافا

// 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 حول الخط المتعدّد.

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

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

مثال

جافا

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

Kotlin

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