עיצוב מפה

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

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

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

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

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

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