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

اختيار النظام الأساسي: 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 حول الخطوط المتعددة الأضلاع.

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

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

مثال

Java

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