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

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

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