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

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