במסמך הזה מוסבר איך להתאים אישית את סמני הרכב והמיקום במפה שבה אתם משתמשים באפליקציה למעקב אחרי משלוחים לצרכנים.
באמצעות Consumer SDK ל-JavaScript, אתם יכולים להתאים אישית את המראה והתחושה של שני סוגים של סמנים שנוספו למפה:
- סמנים של רכבי משלוחים: משתמשים ב-
deliveryVehicleMarkerCustomization - סמני יעד: משתמשים ב-
destinationMarkerCustomization
אפשר לעשות את זה באחת משתי דרכים:
- הכי פשוט: מציינים אובייקט
MarkerOptionsכדי להחיל אותו על כל הסמנים מאותו סוג. לאחר מכן, ערכת ה-SDK לצרכן מחילה את העיצוב בשני מצבים: לפני הוספת הסמנים למפה, וכשהנתונים שמשמשים לסמנים משתנים. - מתקדם יותר: מציינים פונקציית התאמה אישית. פונקציות של התאמה אישית מאפשרות לעצב את הסמנים על סמך נתונים, וגם להוסיף להם אינטראקטיביות, כמו טיפול בקליקים. באופן ספציפי, ה-Consumer SDK מעביר לפונקציית ההתאמה האישית נתונים על סוג האובייקט שהסמן מייצג: רכב או יעד. כך אפשר לשנות את הסגנון של הסמן בהתאם למצב הנוכחי של רכיב הסמן עצמו, למשל מספר העצירות המתוכננות שנותרו עד ליעד. אתם יכולים אפילו לצרף נתונים ממקורות מחוץ ל-Fleet Engine ולעצב את הסמן על סמך המידע הזה.
דוגמה פשוטה: שימוש ב-MarkerOptions
בדוגמה הבאה מוסבר איך להגדיר את הסגנון של סמן הרכב באמצעות אובייקט MarkerOptions. בדוגמה הזו, אטימות הסמן מוגדרת ל-50%.
JavaScript
deliveryVehicleMarkerCustomization = {
opacity: 0.5
};
TypeScript
deliveryVehicleMarkerCustomization = {
opacity: 0.5
};
דוגמה מתקדמת: שימוש בפונקציית התאמה אישית
בדוגמה הבאה מוסבר איך להגדיר את הסגנון של סמן הרכב כך שיוצג מספר העצירות שנותרו לרכב לפני ההגעה לעצירה של המשימה המתוזמנת.
JavaScript
deliveryVehicleMarkerCustomization =
(params) => {
var stopsLeft = params.taskTrackingInfo.remainingStopCount;
params.marker.setLabel(`${stopsLeft}`);
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: ShipmentMarkerCustomizationFunctionParams) => {
const stopsLeft = params.taskTrackingInfo.remainingStopCount;
params.marker.setLabel(`${stopsLeft}`);
};
הוספת טיפול בקליקים לסמנים
אפשר להוסיף טיפול בקליקים לכל סמן, כמו בדוגמה הבאה לסמן של רכב.
JavaScript
deliveryVehicleMarkerCustomization =
(params) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: ShipmentMarkerCustomizationFunctionParams) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
הצגת מידע נוסף על סמנים
אפשר להשתמש ב-InfoWindow כדי להציג מידע נוסף על סמן של רכב או מיקום. בדוגמה הבאה נוצר InfoWindow והוא מצורף לסמן של רכב:
JavaScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
locationProvider.addListener('update', e => {
const stopsCount =
e.taskTrackingInfo.remainingStopCount;
infoWindow.setContent(
`Your vehicle is ${stopsCount} stops away.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
});
// 3. Close the info window.
infoWindow.close();
TypeScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
const stopsCount =
e.taskTrackingInfo.remainingStopCount;
infoWindow.setContent(
`Your vehicle is ${stopsCount} stops away.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
});
// 3. Close the info window.
infoWindow.close();