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

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