עיצוב מפה

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

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

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

כדי להחיל סגנון מפה על מפה של שיתוף מסלול נסיעה ב-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,
  ...
});

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

• התאמה אישית של סמנים
• התאמה אישית של קווים שבורים