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

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

תחילת העבודה עם SDK לצרכן ב-JavaScript

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

רכיבים

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

תצוגת מפה 'התקדמות הנסיעה וההזמנה'

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

ספק המיקום של הנסיעה

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

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

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

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

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

מיקום המוצא

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

מיקום היעד

מיקום היעד הוא המיקום שבו התהליך מסתיים. הוא מסמן את מיקום ההורדה.

מיקום ציון הדרך

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

מיקום הרכב

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

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

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

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

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

שליטה בחשיפה של מיקומים במעקב

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

רכבים

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

כל שאר סמני המיקום

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

תחילת העבודה עם JavaScript SDK

לפני שמשתמשים ב-JavaScript SDK, ודאו שאתם מכירים את Fleet Engine ושאתם יודעים איך מקבלים מפתח API.

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

יצירת תלונה על מזהה נסיעה

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

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

הדוגמה הבאה מציגה איך ליצור אסימון למעקב לפי מזהה נסיעה:

{
  "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": {
     "tripid": "tid_12345",
   }
}

יצירת מאחזר אסימון אימות

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

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

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

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

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

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

הדוגמה הבאה מציגה איך ליצור מאחזר אסימון אימות:

JavaScript

async 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.jwt,
    expiresInSeconds: data.expirationTimestamp - Date.now(),
  };
}

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

נקודת הקצה צריכה להחזיר זמן תפוגה לאסימון. בדוגמה שלמעלה, היא מוגדרת כ-data.ExpiresInSeconds.
מאחזר אסימון האימות צריך להעביר את זמן התפוגה (בשניות, מזמן האחזור) לספרייה, כפי שמוצג בדוגמה.
ה-Server_TOKEN_URL תלוי בהטמעה של הספק. אלה כתובות ה-URL של הספק לדוגמה:
- https://SERVER_URL/token/driver/VEHICLEID
- https://SERVER_URL/token/consumer/TRIPID

טעינת מפה מ-HTML

הדוגמה הבאה מראה איך לטעון את ה-SDK של 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 SDK למעקב אחר נסיעה משותפת או נסיעה. לפני שמריצים את הקוד, חשוב לטעון את הספרייה מפונקציית הקריאה החוזרת שצוינה בתג הסקריפט.

יצירת מופע של ספק מיקום לנסיעות

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

JavaScript

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

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

TypeScript

locationProvider =
    new google.maps.journeySharing
        .FleetEngineTripLocationProvider({
          projectId,
          authTokenFetcher,

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

הפעלה של תצוגת המפה

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

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

JavaScript

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

// If you did not specify a trip ID in the location
// provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.tripId = 'your-trip-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({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  // Styling customizations; see below.
  vehicleMarkerCustomization: vehicleMarkerCustomization,
  activePolylineCustomization: activePolylineCustomization,
  // Any undefined styling options will use defaults.
});

// If you did not specify a trip ID in the location
// provider constructor, you may do so here.
locationProvider.tripId = 'your-trip-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);

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

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

JavaScript

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

TypeScript

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

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

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

JavaScript

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

TypeScript

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

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

הפסקת מעקב

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

JavaScript

locationProvider.tripId = '';

TypeScript

locationProvider.tripId = '';

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

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

JavaScript

mapView.removeLocationProvider(locationProvider);

TypeScript

mapView.removeLocationProvider(locationProvider);

התאמה אישית של המראה והתחושה של המפה הבסיסית

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

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

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

JavaScript

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

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // and 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 SDK תוכל להתאים אישית את המראה והתחושה של סמנים שנוספים למפה. ניתן לעשות זאת על ידי ציון התאמות אישיות של סמנים, שאותן ה-SDK של JavaScript מחיל לפני הוספת הסמנים למפה ובכל עדכון של הסמנים.

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

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

ה-JavaScript SDK מספק את הפרמטרים הבאים להתאמה אישית ב-FleetEngineTripLocationProviderOptions:

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

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

JavaScript

vehicleMarkerCustomization = {
  cursor: 'grab'
};

TypeScript

vehicleMarkerCustomization = {
  cursor: 'grab'
};

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

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

JavaScript

vehicleMarkerCustomization =
  (params) => {
    var distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    const distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
};

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

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

JavaScript

vehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

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

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

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

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

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

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.trip.remainingWaypoints[0].distanceMeters;
    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: TripPolylineCustomizationFunctionParams) => {
    const distance = params.trip.remainingWaypoints[0].distanceMeters;
    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};

עיבוד `Polyline` אובייקטים תוך התייחסות לתנועה

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

JavaScript

// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
  FleetEngineTripLocationProvider.
      TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;

// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
  (params) => {
    FleetEngineTripLocationProvider.
        TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
    for (const polylineObject of params.polylines) {
      if (polylineObject.get('strokeColor') === '#05f') {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

TypeScript

// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
  FleetEngineTripLocationProvider.
      TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;

// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
  (params: TripPolylineCustomizationFunctionParams) => {
    FleetEngineTripLocationProvider.
        TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
    for (const polylineObject of params.polylines) {
      if (polylineObject.get('strokeColor') === '#05f') {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

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

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

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

JavaScript

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

locationProvider.addListener('update', e => {
  const stopsCount = e.trip.remainingWaypoints.length;
  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.FleetEngineTripLocationProviderUpdateEvent) => {
  const stopsCount = e.trip.remainingWaypoints.length;
  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

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

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

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

לדוגמה, נניח שיש לכם דף אינטרנט עם ישות 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, centered at Uluru
  var map = new google.maps.Map(document.getElementById('map'));
  map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});

  // The marker, 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 SDK:

מוסיפים קוד למפעל של אסימון האימות.
הפעלת ספק מיקום בפונקציה 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
async 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.FleetEngineTripLocationProvider({
    projectId: "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.tripId = TRIP_ID;

    // (4) Add customizations like before.

    // The location of Uluru
    var uluru = {lat: -25.344, lng: 131.036};
    // The map, centered at Uluru
    var map = mapView.map;
    map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
    // The marker, 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 SDK 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>

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

תחילת העבודה עם SDK לצרכן ב-JavaScript

רכיבים

תצוגת מפה 'התקדמות הנסיעה וההזמנה'

ספק המיקום של הנסיעה

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

מיקום המוצא

מיקום היעד

מיקום ציון הדרך

מיקום הרכב

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

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

שליטה בחשיפה של מיקומים במעקב

רכבים

כל שאר סמני המיקום

תחילת העבודה עם JavaScript SDK

יצירת תלונה על מזהה נסיעה

יצירת מאחזר אסימון אימות

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

עיבוד Polyline אובייקטים תוך התייחסות לתנועה

JavaScript

TypeScript

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

JavaScript

TypeScript

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

JavaScript

TypeScript

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

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

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

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

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

עיבוד `Polyline` אובייקטים תוך התייחסות לתנועה

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