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

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

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

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

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

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

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

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

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

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

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

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

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

  • כדי לציין מאפיינים מותאמים אישית, משתמשים בשיטות הסגנון 'הגדרה'. מכיוון שהשיטה מספקת ערכי ברירת מחדל לכל מאפיין, צריך לציין רק ערכים מותאמים אישית.

  • כדי להשבית את קו הפוליגון, מגדירים את 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)