עיצוב מפה

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

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

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

כדי להחיל סגנון מפה על מפה לשיתוף נתוני נסיעה ב-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 במאמרי העזרה של ממשק ה-API של JavaScript במפות Google.

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,
  ...
});

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

• התאמה אישית של סמנים
• התאמה אישית של קווים מצולעים