JavaScript'te gezi izleme

Platform seçin: Android iOS JavaScript

Bir yolculuğu paylaştığınızda tüketici uygulamanız yolculuğun konumunu yardımcı olacak bir araçtır. Bunun için uygulamanızın paylaşıma başlaması gerekiyor seyahat sırasında yolculukta ilerlemeyi güncelleyebilir ve yolculuğa çıktığınızı düşünün.

Bu dokümanda, bu süreçteki aşağıdaki temel adımlar ele alınmaktadır:

  1. Harita oluşturun
  2. Bir haritayı başlatma ve paylaşılan yolculuğu gösterme
  3. Gezi seyrini güncelleme ve takip etme
  4. Yolculuk paylaşımını durdur
  5. Yolculuk paylaşımı hatalarını giderme

Harita oluşturun

Web uygulamanızda bir gönderi teslim alma veya teslimatı takip etmek için harita yüklemeniz gerekir. yolculuğunuzu izlemeye başlamak için Tüketici SDK'sını örneklendirin. Yükleyebilirsiniz yeni bir harita kullanın veya mevcut bir haritayı kullanın. Daha sonra ilk kullanıma Tüketici SDK'sını örneklendirmek için kullanılır. Böylece, harita görünümü konumu.

Google Maps JavaScript API'yi kullanarak yeni bir harita yükleme

Yeni bir harita oluşturmak için web uygulamanızda Google Haritalar JavaScript API'sini yükleyin. İlgili içeriği oluşturmak için kullanılan aşağıdaki örnekte, Google Haritalar JavaScript API'sinin nasıl yükleneceği, başlatma kontrolünü tetikler.

  • callback parametresi, API yüklendikten sonra initMap işlevini çalıştırır.
  • defer özelliği, tarayıcının sayfasına gönderir.

Tüketici SDK'sını örneklendirmek için initMap işlevini kullanın. Örneğin:

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

Mevcut bir haritayı yükle

Google Maps JavaScript API tarafından oluşturulmuş mevcut bir haritayı da yükleyebilirsiniz. örneğin halihazırda kullandığınız bir web sitesi gibi.

Örneğin, standart google.maps.Map içeren bir web sayfanız olduğunu varsayalım. aşağıdaki HTML kodunda tanımlandığı şekilde bir işaretçinin gösterildiği öğe. Bu haritanızı, sondaki geri çağırmada aynı initMap işlevini kullanarak gösterir:

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

Mevcut bir haritayı değiştirme

İşaretçiler veya diğer özelleştirmeler içeren mevcut bir haritayı değiştirebilirsiniz. yapabilirsiniz.

Örneğin, standart google.maps.Map içeren bir web sayfanız varsa bir işaretleyicinin gösterildiği varlık varsa haritayı değiştirebilir ve tıklayın. Bu bölümde bu işlemi yapmak için izlemeniz gereken adımlar açıklanmaktadır.

Haritayı değiştirmek ve özelleştirmeleri sürdürmek için adımları uygulayın. Bu adımlar, örnekteki örnekte de numaralandırılmıştır. şöyle olur:

  1. Kimlik doğrulama jetonu fabrikası için kod ekleyin.

  2. initMap() işlevinde bir konum sağlayıcı başlatın.

  3. initMap() işlevinde harita görünümünü başlatın. Görünüm, haritası.

  4. Özelleştirmenizi harita görünümü için geri çağırma işlevine taşıyın başlatma.

  5. API yükleyicisine konum kitaplığını ekleyin.

Aşağıdaki örnekte yapılacak değişiklikler gösterilmektedir. Bir seyahat sırasında Uluru yakınlarında belirtilen kimlik artık haritada oluşturulur:

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

Bir haritayı başlatma ve paylaşılan yolculuğu gösterme

Gezi başladığında uygulamanızın gezi konumu sağlayıcı örneği oluşturması gerekir ve ardından yolculuk paylaşımına başlamak için bir harita başlatın. Aşağıdaki bölümleri inceleyin inceleyebilirsiniz.

Bir gezi konumu sağlayıcıyı örneklendirme

JavaScript SDK'sının önceden tanımlanmış bir konum sağlayıcısı var kullanıma sunuyoruz. Proje kimliğinizi ve bunu örneklendirmek için jeton fabrikanıza bir referans.

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

Harita görünümünü başlatma

JavaScript SDK'sını yükledikten sonra başlat görüntüleyin ve bunu HTML sayfasına ekleyin. Sayfanızda bulunmalı harita görünümünü barındıran bir <div> öğesi. <div> öğesi şu örnekte map_canvas olarak adlandırılmıştır.

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

Gezi seyrini güncelleme ve takip etme

Uygulamanız etkinlikleri dinlemeli ve gezideki ilerlemeyi yolculuk olarak güncellemelidir gerekir. Görev nesnesinden bir geziyle ilgili meta bilgileri alabilirsiniz konum sağlayıcıyı kullanabilirsiniz. Meta bilgiler, ETA ve teslim alma veya bırakmadan önce kalan mesafe Meta bilgilerdeki değişiklikler Bir update etkinliği tetikler. Aşağıdaki örnekte bunların nasıl dinleneceği gösterilmektedir ve önemli değişikliklere değineceğiz.

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

Yolculuk paylaşımını durdur

Yolculuk sona erdiğinde, konum sağlayıcısının hayal edin. Bunun için gezi kimliğini kaldırmanız gerekir. ve konum sağlayıcı. Örnekler için aşağıdaki bölümlere göz atın.

Konum sağlayıcıdan gezi kimliğini kaldırma

Aşağıdaki örnekte, konum sağlayıcıdan gezi kimliğinin nasıl kaldırılacağı gösterilmektedir.

JavaScript

locationProvider.tripId = '';

TypeScript

locationProvider.tripId = '';

Konum sağlayıcıyı harita görünümünden kaldırma

Aşağıdaki örnekte, bir konum sağlayıcının harita görünümünden nasıl kaldırılacağı gösterilmektedir.

JavaScript

mapView.removeLocationProvider(locationProvider);

TypeScript

mapView.removeLocationProvider(locationProvider);

Yolculuk paylaşımı hatalarını giderme

Yolculuk bilgileri tetikleyicisi isteğinden eşzamansız olarak ortaya çıkan hatalar hata olayları. Aşağıdaki örnekte bu etkinliklerin nasıl dinleneceği gösterilmektedir en iyi uygulamaları gözden geçireceğiz.

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

Sırada ne var?

Haritanın stilini ayarlama