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

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