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

מעקב אחר נסיעה ב-JavaScript

בחירת פלטפורמה: Android iOS JavaScript

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

במסמך הזה מפורטים השלבים העיקריים הבאים בתהליך הזה:

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

הגדרת מפה

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

טעינת מפה חדשה באמצעות JavaScript API של מפות Google

כדי ליצור מפה חדשה, צריך לטעון את Google Maps JavaScript API באפליקציית האינטרנט. בדוגמה הבאה מוסבר איך לטעון את Google Maps JavaScript API, להפעיל את ה-SDK ולהפעיל את בדיקת האיפוס.

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

שימוש בפונקציה initMap כדי ליצור את ה-SDK לצרכן. לדוגמה:

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

טעינה של מפה קיימת

אפשר גם לטעון מפה קיימת שנוצרה על ידי Google Maps JavaScript API, כמו כרטיס שאתם כבר משתמשים בו.

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

    <!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 Pier 39 in San Francisco
          var pier39 = {lat: 37.809326, lng: -122.409981};
          // 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 Pier 39
          var marker = new google.maps.Marker({position: pier39, map: map});
        }
        </script>
        <!-- Load the API from the specified URL.
           * The defer attribute allows the browser to render the page while the API loads.
           * The key parameter contains your own API key.
           * 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>

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

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

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

כדי להחליף את המפה ולשמור על ההתאמות האישיות, מוסיפים את שיתוף המסלול לדף ה-HTML לפי השלבים הבאים, שממוספרים גם בדוגמה שבהמשך:

מוסיפים קוד למפעל האסימונים של האימות.
מאתחלים ספק מיקום בפונקציה 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 Pier 39 in San Francisco
        var pier39 = {lat: 37.809326, lng: -122.409981};
        // 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 Pier 39
        var marker = new google.maps.Marker({position: pier39, 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>

הפעלת מפה והצגת ההתקדמות בנסיעה

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

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

ל-JavaScript SDK יש ספק מיקום מוגדר מראש ל-Fleet Engine Rideshare 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: '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',
});

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

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

JavaScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  // Styling customizations; see below.
  vehicleMarkerSetup: vehicleMarkerSetup,
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
  // 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 starts 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 choose.
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.
  vehicleMarkerSetup: vehicleMarkerSetup,
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
  // 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 starts 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 choose.
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.tripId = '';

TypeScript

locationProvider.tripId = '';

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

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

JavaScript

mapView.removeLocationProvider(locationProvider);

TypeScript

mapView.removeLocationProvider(locationProvider);

טיפול בשגיאות בנסיעה

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

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

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

התאמת סגנון למפה