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

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

כדי להתאים אישית את קווי המסלול, משתמשים ב-method‏ 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)

קווים פוליגוניים מודעים לתנועה

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