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

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