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

בחירת פלטפורמה: 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.

במפות 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)