JavaScript: śledzenie podróży

Wybierz platformę: Android iOS JavaScript

Gdy udostępniasz podróż, aplikacja dla konsumentów wyświetla lokalizację odpowiednim pojazdem. Aby to zrobić, aplikacja musi zacząć udostępniać podróż, aktualizować postępy w jej trakcie i przestać udostępniać informacje gdy podróż dobiegnie końca.

W tym dokumencie opisujemy najważniejsze kroki tego procesu:

  1. Konfigurowanie mapy
  2. Zainicjuj mapę i wyświetl udostępnioną podróż
  3. Zaktualizuj i śledź postępy w podróży
  4. Przestań udostępniać trasę
  5. Postępowanie w przypadku błędów udostępniania podróży

Konfigurowanie mapy

Aby śledzić w aplikacji internetowej informacje o odbiorze lub dostawie przesyłki, musisz wczytać mapę i utwórz instancję pakietu Consumer SDK, aby zacząć śledzić swoją drogę do zakupu. Możesz wczytać użyć nowej lub istniejącej. Następnie należy użyć polecenia inicjowania tworzący instancję pakietu Consumer SDK, tak aby widok mapy odpowiadał lokalizację śledzonego produktu.

Wczytywanie nowej mapy przy użyciu interfejsu Google Maps JavaScript API

Aby utworzyć nową mapę, wczytaj interfejs Google Maps JavaScript API w swojej aplikacji internetowej. Poniższy przykład pokazuje, jak wczytać interfejs Google Maps JavaScript API, włączyć SDK i uruchomić sprawdzanie inicjalizacji.

  • Parametr callback uruchamia funkcję initMap po wczytaniu interfejsu API.
  • Atrybut defer pozwala przeglądarce kontynuować renderowanie pozostałej części podczas wczytywania interfejsu API.

Użyj funkcji initMap, aby utworzyć instancję pakietu Consumer SDK. Na przykład:

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

Wczytywanie istniejącej mapy

Możesz też wczytać istniejącą mapę utworzoną za pomocą interfejsu Google Maps JavaScript API. takich jak ten, z którego już korzystasz.

Załóżmy na przykład, że masz stronę internetową ze standardowym elementem google.maps.Map jednostka, w której jest wyświetlany znacznik, zgodnie z definicją podaną w poniższym kodzie HTML. Ten pokazuje mapę przy użyciu tej samej funkcji initMap w wywołaniu zwrotnym na końcu:

    <!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>

Zastępowanie istniejącej mapy

Możesz zastąpić istniejącą mapę, która zawiera znaczniki lub inne dostosowania bez utraty tych ustawień.

Jeśli na przykład masz stronę internetową w standardowej wersji google.maps.Map tego elementu, na którym wyświetlany jest znacznik, możesz zastąpić mapę i zachować znacznik. W tej sekcji opisaliśmy, jak to zrobić.

Aby zastąpić mapę i zachować swoje ustawienia, dodaj udostępnianie podróży do strony HTML za pomocą poniższych kroków. Są one również numerowane w przykładzie, następujące:

  1. Dodaj kod fabryki tokenów uwierzytelniania.

  2. Zainicjuj dostawcę lokalizacji w funkcji initMap().

  3. Zainicjuj widok mapy w funkcji initMap(). Widok zawiera mapy.

  4. Przenieś dostosowanie do funkcji wywołania zwrotnego dla widoku mapy jego zainicjowanie.

  5. Dodaj bibliotekę lokalizacji do programu wczytującego interfejs API.

Przykład poniżej pokazuje zmiany, które należy wprowadzić. Jeśli podróżujesz z: o podanym identyfikatorze w pobliżu Uluru, teraz zostanie wyrenderowany na mapie:

    <!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>

Zainicjuj mapę i wyświetl udostępnioną podróż

Gdy rozpoczyna się podróż, aplikacja musi utworzyć instancję dostawcy lokalizacji podróży a następnie zainicjuj mapę, aby rozpocząć udostępnianie podróży. Patrz następujące sekcje .

Utwórz instancję dostawcy usług lokalizacji dla podróży

Pakiet JavaScript SDK ma wstępnie zdefiniowanego dostawcę lokalizacji dla interfejsu Fleet Engine Ridesharing API. Użyj identyfikatora projektu odwołanie do fabryki tokenów do utworzenia jej instancji.

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

Inicjowanie widoku mapy

Po wczytaniu pakietu SDK JavaScript zainicjuj widok mapy i dodać go do strony HTML. Strona powinna zawierać element <div>, który zawiera widok mapy. Element <div> w poniższym przykładzie nazwano 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);

Zaktualizuj i śledź postępy w podróży

Aplikacja powinna nasłuchiwać zdarzeń i aktualizować postępy w podróży w formie podróży Twoje postępy. Z obiektu zadania możesz pobrać metainformacje o podróży przy użyciu dostawcy lokalizacji. Metadane obejmują szacowany czas dotarcia na miejsce i pozostały dystans do odbioru lub dostawy. Zmiany metadanych wywołuje zdarzenie update. Przykład poniżej pokazuje, jak ich słuchać zdarzenia zmiany.

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

Przestań udostępniać trasę

Po zakończeniu podróży należy zatrzymać usługę lokalizacji od śledzenia podróży. Aby to zrobić, usuń identyfikator podróży i dostawcę lokalizacji. Przykłady znajdziesz w sekcjach poniżej.

Usuń identyfikator podróży z systemu dostawcy lokalizacji

Przykład poniżej pokazuje, jak usunąć identyfikator podróży u dostawcy lokalizacji.

JavaScript

locationProvider.tripId = '';

TypeScript

locationProvider.tripId = '';

Usuń dostawcę lokalizacji z widoku mapy

Poniższy przykład pokazuje, jak usunąć dostawcę lokalizacji z widoku mapy.

JavaScript

mapView.removeLocationProvider(locationProvider);

TypeScript

mapView.removeLocationProvider(locationProvider);

Postępowanie w przypadku błędów udostępniania podróży

Błędy, które powstają asynchronicznie podczas żądania aktywacji informacji o podróży tych zdarzeń. Przykład poniżej pokazuje, jak nasłuchiwać tych zdarzeń obsługi błędów.

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

Co dalej?

Określanie stylu mapy