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

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