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

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

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