עיצוב מפה

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

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

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

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

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

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

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 במאמרי העזרה של Google Maps JavaScript API.

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

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. אתם יכולים להשתמש באפשרויות הבאות כדי ליצור קריטריונים שקובעים את החשיפה של רכיב במשימה:

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

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

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

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

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

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

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
    

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

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

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

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

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

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

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