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

דף זה תורגם על ידי Cloud Translation API.

מעקב אחרי משלוחים באמצעות ספריית המעקב אחר משלוחים ב-JavaScript

הספרייה למעקב אחר משלוחים ב-JavaScript מאפשרת להציג באופן חזותי את המיקום של כלי הרכב ואת המיקומים שיש בהם מעקב ב-Fleet Engine. הספרייה מכילה רכיב מפה של JavaScript שמחליף את ההתקנה בישות google.maps.Map רגילה וברכיבי נתונים שאפשר להתחבר אל Fleet Engine. בעזרת ספריית המעקב אחר משלוחים ב-JavaScript, אתם יכולים לספק מאפליקציית האינטרנט שלכם אנימציה של מעקב אחרי משלוחים, שמותאמת אישית.

רכיבים

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

תצוגת מפה 'מעקב אחר משלוחים'

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

ספק המיקום של המשלוחים

ספק של מיקומי משלוחים מוסיף את פרטי המיקום של האובייקטים במעקב למפת המעקב אחרי המשלוח כדי לעקוב אחרי המשלוח הראשון והאחרון.

אפשר להשתמש בספק של מיקום המשלוח כדי לעקוב אחרי:

היעד לאיסוף או למשלוח של המשלוח.
המיקום והמסלול של רכב המשלוחים.

אובייקטים של מיקום במעקב

ספק המיקום עוקב אחר המיקום של אובייקטים כמו כלי רכב ויעדים.

מיקום היעד

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

מיקום הרכב

מיקום הרכב הוא המיקום של הרכב במעקב. הוא יכול לכלול גם מסלול לרכב.

שליפת אסימון אימות

כדי לשלוט בגישה לנתוני המיקום שמאוחסנים ב-Fleet Engine, צריך להטמיע בשרת שירות כריית אסימון אינטרנט מסוג JSON (JWT) ל-Fleet Engine. לאחר מכן תוכלו להטמיע מאחזר של אסימון אימות כחלק מאפליקציית האינטרנט, באמצעות ספריית השיתוף של התהליך ב-JavaScript, כדי לאמת את הגישה לנתוני המיקום.

אפשרויות עיצוב

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

שליטה בהרשאות הגישה של מיקומים שבמעקב

בקטע הזה מתוארים פקדי החשיפה של אובייקטים במעקב במפה. הכללים האלו חלים על שתי קטגוריות של אובייקטים:

סמן מיקום
נתוני המשימה

החשיפה של סמן המיקום

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

הרשאות גישה לנתונים של המשימה

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

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

משימות של חוסר זמינות

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

משימות רכב פעילות

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

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

אפשר להתאים אישית את הגדרות החשיפה לכל משימה באמצעות הגדרת ה-TaskTrackingViewConfig עבור המשימה כשיוצרים או מעדכנים אותה ב-Fleet Engine. כך נוצרים כללים שקובעים מתי יש אלמנטים ספציפיים של נתונים, שיכולים להתבסס על הקריטריונים הבאים (אפשרות החשיפה נקראת בהמשך):

מספר העצירות שנותרו
משך הזמן עד לשעת ההגעה המשוערת
מרחק הנסיעה שנשאר
הצגת הלחצן תמיד
לא גלוי אף פעם

שימו לב שאפשר לשייך כל רכיב נתונים רק לאפשרות חשיפה אחת. לא ניתן לשלב קריטריונים באמצעות OR או AND.

הנה דוגמה להתאמה אישית. הכללים לביצוע התאמה אישית הם:

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

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

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

קווים פוליגוניים וכללי חשיפת מיקום של רכבים:

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

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

אם לקווים פוליגוניים של נתיבים ולמיקום הרכב יש אפשרות חשיפה זהה:
- אם אפשרות החשיפה היא ספירת העצירה, משך הזמן עד זמן ההגעה המשוער, או מרחק הנסיעה שנותר, בקווים פוליגוניים של מסלולים צריך לציין ערך שקטן מהערך שהוגדר לאפשרות החשיפה של מיקום הרכב או שווה לו. כך לדוגמה:
```
"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "vehicleLocationVisibility": {
    "remainingStopCountThreshold": 5
  },
}
```
- אם לקווים פוליגוניים יש אפשרות חשיפה תמידית, במיקום הרכב צריכה להיות גם אפשרות חשיפה גלויה תמיד.
- אם למיקום הרכב אף פעם אין אפשרות חשיפה גלויה, בקווים פוליגוניים של נתיבים צריכה להיות גם אפשרות חשיפה שאף פעם לא גלויה.
אם לקווים פוליגוניים של נתיבים ולמיקום הרכב יש אפשרויות חשיפה שונים, אפשר לראות את מיקום הרכב רק אם שתי אפשרויות החשיפה מתקיימות.

כך לדוגמה:
```
"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "vehicleLocationVisibility": {
    "remainingDrivingDistanceMetersThreshold": 3000
  },
}
```
בדוגמה הזו, מיקום הרכב מוצג רק אם מספר העצירות הנותר הוא לפחות 3, וגם מרחק הנסיעה הנותר הוא לפחות 3,000 מטר.

תחילת העבודה עם ספריית השיתוף של התהליך ב-JavaScript

לפני שמשתמשים ב-JavaScript Journey Share Library, חשוב שתכירו את Fleet Engine ואיך מקבלים מפתח API.

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

יצירת בקשה למזהה לצורכי מעקב

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

כדי ליצור את המטען הייעודי (payload) של JWT, מוסיפים הצהרה נוספת בקטע ההרשאה עם trackingid של המפתח. מגדירים את הערך כמזהה לצורכי מעקב אחר המשלוח.

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

{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "private_key_id_of_consumer_service_account"
}
.
{
  "iss": "consumer@yourgcpproject.iam.gserviceaccount.com",
  "sub": "consumer@yourgcpproject.iam.gserviceaccount.com",
  "aud": "https://fleetengine.googleapis.com/",
  "iat": 1511900000,
  "exp": 1511903600,
  "scope": "https://www.googleapis.com/auth/xapi",
  "authorization": {
     "trackingid": "tid_54321",
   }
}

יצירת שליפת אסימון אימות

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

המאחזר צריך להחזיר מבנה נתונים עם שני שדות, שמוקף בהבטחה:

מחרוזת token.
מספר expiresInSeconds. התוקף של האסימון יפוג תוך פרק הזמן הזה אחרי השליפה.

הספרייה למעקב אחר משלוחים ב-JavaScript מבקשת אסימון דרך מאחזר אסימוני האימות כשמתקיים אחד מהתנאים הבאים:

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

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

הדוגמה הבאה מציגה איך ליצור כלי לשליפה של אסימון אימות:

JavaScript

function authTokenFetcher(options) {
  // options is a record containing two keys called
  // serviceType and context. The developer should
  // generate the correct SERVER_TOKEN_URL and request
  // based on the values of these fields.
  const response = await fetch(SERVER_TOKEN_URL);
  if (!response.ok) {
    throw new Error(response.statusText);
  }
  const data = await response.json();
  return {
    token: data.Token,
    expiresInSeconds: data.ExpiresInSeconds
  };
}

TypeScript

function authTokenFetcher(options: {
  serviceType: google.maps.journeySharing.FleetEngineServiceType,
  context: google.maps.journeySharing.AuthTokenContext,
}): Promise<google.maps.journeySharing.AuthToken> {
  // The developer should generate the correct
  // SERVER_TOKEN_URL based on options.
  const response = await fetch(SERVER_TOKEN_URL);
  if (!response.ok) {
    throw new Error(response.statusText);
  }
  const data = await response.json();
  return {
    token: data.token,
    expiresInSeconds: data.expiration_timestamp_ms - Date.now(),
  };
}

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

נקודת הקצה חייבת להחזיר מועד תפוגה של האסימון. בדוגמה שלמעלה, הוא מוגדר כ-data.ExpiresInSeconds.
מאחזר אסימון האימות חייב להעביר את מועד התפוגה (בשניות, ממועד השליפה) לספרייה, כפי שמוצג בדוגמה.
ה-server_TOKEN_URL תלוי בהטמעה של הקצה העורפי. אלה כתובות ה-URL של הקצה העורפי לדוגמה של האפליקציה:
- https://SERVER_URL/token/delivery_driver/DELIVERY_VEHICLE_ID
- https://SERVER_URL/token/delivery_consumer/TRACKING_ID
- https://SERVER_URL/token/fleet_reader

טעינת מפה מ-HTML

בדוגמה הבאה אפשר לראות איך לטעון את ספריית ה-JavaScript למעקב אחר משלוחים מכתובת URL ספציפית. הפרמטר callback מריץ את הפונקציה initMap אחרי שה-API נטען. המאפיין defer מאפשר לדפדפן להמשיך לעבד את שאר הדף בזמן שה-API נטען.

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>

מעקב אחרי משלוח

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

יצירת זהות של ספק של מיקום משלוח

הספרייה למעקב אחר משלוחים ב-JavaScript מגדירה מראש ספק מיקום ל-Fleet Engine Deliveries API. משתמשים במזהה הפרויקט ובהפניה למפעל האסימון שלכם כדי ליצור אותו.

JavaScript

locationProvider =
    new google.maps.journeySharing
        .FleetEngineShipmentLocationProvider({
          projectId: 'your-project-id',
          authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step

          // Optionally, you may specify tracking ID to
          // immediately start tracking.
          trackingId: 'your-tracking-id',
});

TypeScript

locationProvider =
    new google.maps.journeySharing
        .FleetEngineShipmentLocationProvider({
          projectId: 'your-project-id',
          authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step

          // Optionally, you may specify tracking ID to
          // immediately start tracking.
          trackingId: 'your-tracking-id',
});

אתחול תצוגת המפה

אחרי שטוענים את ספריית Journey Sharing ב-JavaScript, מאתחלים את תצוגת המפה ומוסיפים אותה לדף ה-HTML. הדף צריך להכיל רכיב <div> שכולל את תצוגת המפה. בדוגמה הבאה, הרכיב <div> נקרא map_canvas.

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

JavaScript

const mapView = new 
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'), 
  locationProviders: [locationProvider],
  vehicleMarkerSetup: vehicleMarkerSetup,
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
  // Any undefined styling options will use defaults.
});

// If you did not specify a tracking ID in the location
// provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.trackingId = 'your-tracking-id';

// Give the map an initial viewport to allow it to 
// initialize; otherwise the 'ready' event above may 
// not fire. The user also has access to the mapView
// object to customize as they wish.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);

TypeScript

const mapView = new 
    google.maps.journeySharing.JourneySharingMapView({
  document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  vehicleMarkerSetup: vehicleMarkerSetup,
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
 // Any undefined styling options will use defaults.
});

// If you did not specify a tracking ID in the location
// provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.trackingId = 'your-tracking-id';

// Give the map an initial viewport to allow it to
// initialize; otherwise the 'ready' event above may 
// not fire. The user also has access to the mapView
// object to customize as they wish.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);

מזהה לצורכי מעקב

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

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

האזנה לאירועי שינויים

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

JavaScript

locationProvider.addListener('update', e => {
  // e.taskTrackingInfo contains data that may be useful
  // to the rest of the UI.
  console.log(e.taskTrackingInfo.remainingStopCount);
});

TypeScript

locationProvider.addListener('update',
    (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
  // e.taskTrackingInfo contains data that may be useful
  // to the rest of the UI.
  console.log(e.taskTrackingInfo.remainingStopCount);
});

טיפול בשגיאות

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

JavaScript

locationProvider.addListener('error', e => {
  // e.error is the error that triggered the event.
  console.error(e.error);
});

TypeScript

locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
  // e.error is the error that triggered the event.
  console.error(e.error);
});

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

הפסקת מעקב

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

JavaScript

locationProvider.trackingId = '';

TypeScript

locationProvider.trackingId = '';

הסרת ספק המיקום מתצוגת המפה

בדוגמה הבאה ניתן לראות איך להסיר ספק מיקום מתצוגת המפה.

JavaScript

mapView.removeLocationProvider(locationProvider);

TypeScript

mapView.removeLocationProvider(locationProvider);

התאמה אישית של העיצוב והסגנון של המפה הבסיסית

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

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

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

JavaScript

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

TypeScript

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

שימוש בעיצוב מפה מבוסס-קוד

דרך נוספת להתאמה אישית של עיצוב המפה היא להגדיר את mapOptions כשיוצרים את JourneySharingMapView.

JavaScript

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

TypeScript

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

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

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

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

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

הספרייה 'מעקב אחר משלוחים' מספקת את הפרמטרים הבאים להתאמה אישית ב-FleetEngineShipmentLocationProviderOptions:

שינוי הסגנון של הסמנים באמצעות `MarkerOptions`

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

JavaScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

TypeScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

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

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

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

שימוש בהתאמה אישית של קו פוליגוני

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

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

באותו אופן, אפשר לציין פונקציית התאמה אישית. פונקציות של התאמה אישית מאפשרות עיצוב ספציפי של האובייקטים על סמך נתונים שנשלחים על ידי Fleet Engine. הפונקציה יכולה לשנות את העיצוב של כל אובייקט בהתאם למצב הנוכחי של המשלוח. לדוגמה, לצבוע את האובייקט Polyline בגוון עמוק יותר או להפוך אותו לעבה יותר כשהרכב נע לאט יותר. אפשר אפילו להצטרף כנגד מקורות מחוץ ל-Fleet Engine ולעצב את האובייקט Polyline על סמך המידע הזה.

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

takenPolylineCustomization, לנתיב שכבר עבר בו;
activePolylineCustomization, לנתיב נסיעה פעיל;
remainingPolylineCustomization, לנתיב שעדיין לא עברתם.

שינוי העיצוב של `Polyline` אובייקטים באמצעות `PolylineOptions`

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

JavaScript

activePolylineCustomization = {
  strokeWidth: 5,
  strokeColor: 'black',
};

TypeScript

activePolylineCustomization = {
  strokeWidth: 5,
  strokeColor: 'black',
};

שינוי העיצוב של `Polyline` אובייקטים באמצעות פונקציות של התאמה אישית

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

JavaScript

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params) => {
    const distance = params.taskTrackingInfo.remainingDrivingDistanceMeters;
    if (distance < 1000) {

      // params.polylines contains an ordered list of Polyline objects for
      // the path.
      for (const polylineObject of params.polylines) {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

TypeScript

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params: ShipmentPolylineCustomizationFunctionParams) => {
    const distance = params.taskTrackingInfo.remainingDrivingDistanceMeters;
    if (distance < 1000) {

      // params.polylines contains an ordered list of Polyline objects for
      // the path.
      for (const polylineObject of params.polylines) {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

שליטה בחשיפה של `Polyline` אובייקטים

כברירת מחדל, כל האובייקטים של Polyline גלויים. כדי להפוך אובייקט Polyline לבלתי נראה, מגדירים את המאפיין visible שלו:

JavaScript

remainingPolylineCustomization = {visible: false};

TypeScript

remainingPolylineCustomization = {visible: false};

הצגת `InfoWindow` לסימון רכב או מיקום

תוכלו להשתמש ב-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();

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

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

JavaScript

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

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();

החלפה של מפה קיימת

בעזרת ספריית המעקב אחר משלוחים ב-JavaScript תוכלו להחליף מפה קיימת שכוללת סמנים או התאמות אישיות אחרות, בלי לאבד את ההתאמות האישיות האלה.

לדוגמה, נניח שיש לכם דף אינטרנט עם ישות google.maps.Map רגילה שבה מוצג סמן:

<!DOCTYPE html>
<html>
  <head>
    <style>
       /* Set the size of the div element that contains the map */
      #map {
        height: 400px;  /* The height is 400 pixels */
        width: 100%;  /* The width is the width of the web page */
       }
    </style>
  </head>
  <body>
    <h3>My Google Maps Demo</h3>
    <!--The div element for the map -->
    <div id="map"></div>
    <script>
// Initialize and add the map
function initMap() {
  // The location of Uluru
  var uluru = {lat: -25.344, lng: 131.036};
  // The map, initially centered at Mountain View, CA.
  var map = new google.maps.Map(document.getElementById('map'));
  map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});

  // The marker, now positioned at Uluru
  var marker = new google.maps.Marker({position: uluru, map: map});
}
    </script>
    <!-- Load the API from the specified URL.
       * The async attribute allows the browser to render the page while the API loads.
       * The key parameter will contain your own API key (which is not needed for this tutorial).
       * The callback parameter executes the initMap() function.
    -->
    <script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  </body>
</html>

כדי להוסיף את הספרייה של JavaScript Journey Share:

צריך להוסיף קוד למפעל של אסימון האימות.
מפעילים ספק מיקום בפונקציה initMap().
אפשר לאתחל את תצוגת המפה בפונקציה initMap(). התצוגה מכילה את המפה.
מעבירים את ההתאמה האישית לפונקציית הקריאה החוזרת של תצוגת המפה.
מוסיפים את ספריית המיקומים לטעינת ה-API.

בדוגמה הבאה מוצגים השינויים שצריך לבצע:

<!DOCTYPE html>
<html>
  <head>
    <style>
       /* Set the size of the div element that contains the map */
      #map {
        height: 400px;  /* The height is 400 pixels */
        width: 100%;  /* The width is the width of the web page */
       }
    </style>
  </head>
  <body>
    <h3>My Google Maps Demo</h3>
    <!--The div element for the map -->
    <div id="map"></div>
    <script>
let locationProvider;

// (1) Authentication Token Fetcher
function authTokenFetcher(options) {
  // options is a record containing two keys called 
  // serviceType and context. The developer should
  // generate the correct SERVER_TOKEN_URL and request
  // based on the values of these fields.
  const response = await fetch(SERVER_TOKEN_URL);
      if (!response.ok) {
        throw new Error(response.statusText);
      }
      const data = await response.json();
      return {
        token: data.Token,
        expiresInSeconds: data.ExpiresInSeconds
      };
}

// Initialize and add the map
function initMap() {
  // (2) Initialize location provider.
  locationProvider = new google.maps.journeySharing.FleetEngineShipmentLocationProvider({
    YOUR_PROVIDER_ID,
    authTokenFetcher,
  });

  // (3) Initialize map view (which contains the map).
  const mapView = new google.maps.journeySharing.JourneySharingMapView({
    element: document.getElementById('map'),
    locationProviders: [locationProvider],
    // any styling options
  });

  locationProvider.trackingId = TRACKING_ID;

    // (4) Add customizations like before.

    // The location of Uluru
    var uluru = {lat: -25.344, lng: 131.036};
    // The map, initially centered at Mountain View, CA.
    var map = mapView.map;
    map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
    // The marker, now positioned at Uluru
    var marker = new google.maps.Marker({position: uluru, map: map});
  };

    </script>
    <!-- Load the API from the specified URL
      * The async attribute allows the browser to render the page while the API loads
      * The key parameter will contain your own API key (which is not needed for this tutorial)
      * The callback parameter executes the initMap() function
      *
      * (5) Add the journey sharing library to the API loader.
    -->
    <script defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing">
    </script>
  </body>
</html>

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

מעקב אחרי משלוחים באמצעות ספריית המעקב אחר משלוחים ב-JavaScript

רכיבים

תצוגת מפה 'מעקב אחר משלוחים'

ספק המיקום של המשלוחים

אובייקטים של מיקום במעקב

מיקום היעד

מיקום הרכב

שליפת אסימון אימות

אפשרויות עיצוב

שליטה בהרשאות הגישה של מיקומים שבמעקב

החשיפה של סמן המיקום

הרשאות גישה לנתונים של המשימה

משימות של חוסר זמינות

משימות רכב פעילות

קווים פוליגוניים וכללי חשיפת מיקום של רכבים:

תחילת העבודה עם ספריית השיתוף של התהליך ב-JavaScript

יצירת בקשה למזהה לצורכי מעקב

יצירת שליפת אסימון אימות

JavaScript

TypeScript

טעינת מפה מ-HTML

מעקב אחרי משלוח

יצירת זהות של ספק של מיקום משלוח

JavaScript

TypeScript

אתחול תצוגת המפה

JavaScript

TypeScript

מזהה לצורכי מעקב

האזנה לאירועי שינויים

JavaScript

TypeScript

טיפול בשגיאות

JavaScript

TypeScript

הפסקת מעקב

JavaScript

TypeScript

הסרת ספק המיקום מתצוגת המפה

JavaScript

TypeScript

התאמה אישית של העיצוב והסגנון של המפה הבסיסית

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

JavaScript

TypeScript

שימוש בעיצוב מפה מבוסס-קוד

JavaScript

TypeScript

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

שינוי הסגנון של הסמנים באמצעות MarkerOptions

JavaScript

TypeScript

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

JavaScript

TypeScript

הוספת טיפול בקליקים לסמנים

JavaScript

TypeScript

שימוש בהתאמה אישית של קו פוליגוני

שינוי העיצוב של Polyline אובייקטים באמצעות PolylineOptions

JavaScript

TypeScript

שינוי העיצוב של Polyline אובייקטים באמצעות פונקציות של התאמה אישית

JavaScript

TypeScript

שליטה בחשיפה של Polyline אובייקטים

JavaScript

TypeScript

הצגת InfoWindow לסימון רכב או מיקום

JavaScript

TypeScript

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

JavaScript

TypeScript

החלפה של מפה קיימת

שינוי הסגנון של הסמנים באמצעות `MarkerOptions`

שינוי העיצוב של `Polyline` אובייקטים באמצעות `PolylineOptions`

שינוי העיצוב של `Polyline` אובייקטים באמצעות פונקציות של התאמה אישית

שליטה בחשיפה של `Polyline` אובייקטים

הצגת `InfoWindow` לסימון רכב או מיקום