עיצוב מפה

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

  • שימוש בעיצוב מפות מבוסס-ענן
  • הגדרת אפשרויות של סגנון המפה ישירות בקוד שלכם

עיצוב המפה באמצעות עיצוב מפות מבוסס-ענן

כדי להחיל סגנון מפה על מפה לשיתוף מסלול של משתמש ב-JavaScript, צריך לציין mapId וmapOptions אחרים כשיוצרים את JourneySharingMapView.

בדוגמאות הבאות אפשר לראות איך להחיל סגנון מפה באמצעות מזהה מפה.

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

עיצוב מפות ישירות בקוד שלכם

אפשר גם להתאים אישית את הסגנון של המפה על ידי הגדרת אפשרויות המפה כשיוצרים את האובייקט JourneySharingMapView. בדוגמאות הבאות אפשר לראות איך מעצבים מפה באמצעות אפשרויות של מפה. מידע נוסף על האפשרויות להגדרת המפה זמין במאמר בנושא mapOptionsבמאמרי העזרה של ממשק ה-API של JavaScript במפות Google.

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

שליטה בהרשאות הגישה של נתוני המשימות ל-SDK

אתם יכולים לשלוט בנראות של אובייקטים מסוימים של משימות במפה באמצעות כללי נראות.

ברירת המחדל של הרשאות הגישה לנתוני המשימות

כברירת מחדל, הנתונים של משימות שמוקצות לרכב גלויים כשהרכב נמצא במרחק של עד 5 תחנות מהמשימה. הגישה מסתיימת כשהמשימה מסתיימת או מבוטלת.

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

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

התאמה אישית של הרשאות הגישה למשימות פתוחות שקשורות לרכב

ממשק TaskTrackingInfo מספק מספר אלמנטים של נתוני משימות שאפשר להציג באמצעות Consumer SDK.

רכיבי נתוני משימות שניתנים להתאמה אישית

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

זמן ההגעה המשוער

הזמן המשוער להשלמת המשימה

מרחק הנהיגה שנותר עד למשימה

מספר התחנות שנותרו

מיקום הרכב

אפשרויות הרשאות גישה לכל משימה

אתם יכולים להתאים אישית את הגדרות הגישה לכל משימה בנפרד על ידי הגדרת TaskTrackingViewConfig כשאתם יוצרים או מעדכנים משימה ב-Fleet Engine. אתם יכולים להשתמש באפשרויות החשיפה הבאות כדי ליצור קריטריונים לקביעת החשיפה של רכיב במשימה:

אפשרויות של הרשאות גישה

מספר התחנות שנותרו

משך הזמן עד לשעת ההגעה המשוערת

מרחק הנהיגה שנותר

מוצג תמיד

לא גלוי אף פעם

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

אלמנט הנתונים שרוצים לשנות חשיפה קריטריון
קו פוליגוני של מסלול הצגה הרכב נמצא במרחק של עד 3 תחנות.
זמן הגעה משוער הצגה המרחק שנותר לנסיעה קצר מ-5,000 מטרים.
מספר התחנות שנותרו אל תציג לעולם הרכב נמצא במרחק של עד 3 תחנות.

בדוגמה הבאה אפשר לראות את ההגדרה הזו:

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

כללי חשיפה של קווי פוליגון של מסלולים ומיקום הרכב

אי אפשר לראות את קווי המתאר של המסלול אלא אם רואים גם את מיקום הרכב. אחרת, אפשר להסיק את מיקום הרכב לפי סוף קו המתאר.

ההנחיות האלה יעזרו לכם לספק שילוב תקין של אפשרויות לגבי קו המסלול (polyline) ומיקום הרכב.

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

מגדירים את האפשרויות של קו המסלול לערך שקטן מהערך שהוגדר למיקום הרכב או שווה לו. לדוגמה:

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
אפשרויות שונות של הרשאת גישה קריטריונים לחשיפה הנחיות
מיקום הרכב גלוי

זה קורה רק אם שני התנאים הבאים מתקיימים: המיקום של הרכב גלוי והקו המקוטע גלוי. לדוגמה:

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

בדוגמה הזו, מיקום הרכב גלוי רק אם מספר התחנות שנותרו הוא לפחות 3 וגם מרחק הנסיעה שנותר הוא לפחות 3,000 מטרים.

השבתת ההתאמה האוטומטית

כדי למנוע את ההתאמה האוטומטית של אזור התצוגה לרכב ולמסלול הצפוי, אפשר להשבית את ההתאמה האוטומטית. בדוגמה הבאה מוצג איך להשבית את ההתאמה האוטומטית כשמגדירים את תצוגת המפה של שיתוף המסלול.

JavaScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

TypeScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

המאמרים הבאים