התאמה אישית של קווים פוליגוניים של נתיב

בחירת פלטפורמה: Android iOS JavaScript

אפשר להתאים אישית קווים פוליגונליים של מסלולים באמצעות השיטה ConsumerMapStyle.setPolylineStyleOptions. אם מגדירים אפשרויות מותאמות אישית של קווים פוליגונים, הן מבטלות את ערכי ברירת המחדל שסופקו על ידי Consumer SDK.

כדי לשחזר את ערכי ברירת המחדל, צריך להפעיל את setPolylineStyleOptions עם הערך null לפרמטר PolylineOptions.

כדי לאחזר את PolylineOptions הפעיל, משתמשים בשיטה getPolylineStyleOptions.

מידע נוסף זמין במאמר ConsumerMapStyle.setPolylineStyleOptions.

סוגי קווים פוליגונים של מסלולים

אפשר להתאים אישית את סוגי הקווים הפוליגונליים הבאים של מסלולים:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE ו-REMAINING_ROUTE מוצגים במהלך מעקב אחרי נסיעה, והם מייצגים את מסלול הרכב.

מאפייני קו מרובע של מסלול

במפות Google יש מאפיינים שניתן להתאים אישית לכל קו פוליגון ב-PolylineOptions.

  • כדי ליצור את PolylineOptions, משתמשים ב-constructor שלו.

  • כדי לציין מאפיינים מותאמים אישית, משתמשים בשיטות בסגנון '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)

קווים מרובים עם התחשבות בתנועה

שכבת התנועה של קו הפוליגון מושבתת כברירת מחדל. כשמפעילים את ההגדרה הזו, ה-renderer מצייר קטעים מעל לקו הפוליגון של המסלול שמייצגים קטעי תנועה לא רגילים. הוא כולל תיקון בהתאם לתנאי התנועה. מידע נוסף זמין במסמכי התיעוד למפתחים של 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)