JavaScript Tüketici SDK'sı hızlı referansı

JavaScript Tüketici SDK'sı, web tabanlı bir tüketici uygulamasının, Fleet Engine'da izlenen araçların konumunu ve ilgilenilen diğer konumları haritada göstermesini sağlar. Böylece tüketiciler, isteğe bağlı bir gezinin veya planlanmış bir gönderinin ilerleme durumunu takip edebilir. Maps JavaScript API'nin journeySharing kitaplığı olarak yüklenir.

JavaScript Tüketici SDK'sı: Önemli bilgiler

  • Ürün: JavaScript Tüketici SDK'sı
  • Diğer adları: JavaScript için Tüketici SDK'sı, Mobilite hizmetleri seç-izle geziler JavaScript, JavaScript SDK'sı
  • Kategori: Rotalar
  • Platform: JavaScript (tarayıcı)
  • Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: JavaScript Tüketici SDK'sına genel bakış

JavaScript Tüketici SDK'sı: Ne zaman kullanılır?

JavaScript Tüketici SDK'sını şu durumlarda kullanın:

  • Tüketicilere, Fleet Engine'ın takip ettiği isteğe bağlı bir yolculuk için aracın canlı konumunu ve rotasını bir web sayfasında veya web uygulamasında göstermeniz gerekir.
  • Tüketicilerin, Fleet Engine'da takip edilen planlanmış bir gönderinin teslim alma veya teslimat ilerleme durumunu tarayıcıda takip etmesine izin vermeniz gerekir.
  • Web tabanlı bir harita görünümünde bir seyahat için TVS'yi, kalan mesafeyi ve rotadaki canlı trafiği göstermeniz gerekiyor.
  • Web tüketici takip görünümünde gezi işaretçilerini, rota çoklu çizgilerini veya harita stilini özelleştirmeniz gerekiyorsa

JavaScript Tüketici SDK'sını şu durumlarda kullanmayın:

  • Yerel bir Android uygulamasında gezi takibi tüketici deneyimine ihtiyacınız var. Bunun yerine Android için Tüketici SDK'sını kullanın.
  • Yerel bir iOS uygulamasında gezi takibi tüketici deneyimine ihtiyacınız var. Bunun yerine iOS için Tüketici SDK'sını kullanın.
  • Sürücünün Android uygulamasından sürücü konumunu ve gezi ilerleme durumunu Fleet Engine'e bildirmeniz gerekir. Bunun yerine Android için Sürücü SDK'sını kullanın.
  • Sürücünün iOS uygulamasından sürücü konumunu ve gezi ilerleme durumunu Fleet Engine'e bildirmeniz gerekir. Bunun yerine iOS için Sürücü SDK'sı'nı kullanın.
  • Fleet Engine gezilerini veya görevlerini takip etmeyen genel bir web haritasına ihtiyacınız vardır. Bunun yerine Maps JavaScript API'yi kullanın.

JavaScript Tüketici SDK'sı: kurulum

JavaScript Tüketici SDK'sı: Sık yapılan hatalar

  • Sorun: JourneySharingMapView haritasına ilk görüntü alanını (merkez ve yakınlaştırma) vermezseniz haritanın 'ready' etkinliği tetiklenmeyebilir. Düzeltme: Harita görünümünü oluşturduktan sonra mapView.map.setCenter(...) ve mapView.map.setZoom(...) yöntemlerini çağırın. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey adresini inceleyin.
  • Sorun: Eşzamansız gezi bilgileri isteklerinden kaynaklanan hatalar gösterilmiyor. Konum sağlayıcıda yalnızca 'error' etkinlikleri olarak gelirler. Bu nedenle, dinleyici eklemediğiniz sürece fark edilmezler. Düzeltme: locationProvider.addListener('error', ...) ekleyin ve kitaplık çağrılarını try...catch bloklarına sarmalayın. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey adresini inceleyin.
  • Sorun: journeySharing kitaplığını yüklemediğiniz sürece google.maps.journeySharing sınıfları kullanılamaz. Düzeltme: Maps JavaScript API komut dosyası URL'sine libraries=journeySharing ekleyin veya sınıfları await google.maps.importLibrary("journeySharing") ile yükleyin. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey adresini inceleyin.
  • Sorun: Tarayıcıdan (güvenilirliği düşük bir ortam) yapılan Fleet Engine çağrıları, arka uç sunucunuzun verdiği JWT'leri gerektirir. API anahtarı tek başına gezi verilerine erişim yetkisi vermez. Düzeltme: Arka ucunuzdan JWT'ler yayınlayın ve jeton ile expiresInSeconds döndüren bir authTokenFetcher sağlayın. /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup adresini inceleyin.

JavaScript Consumer SDK: eski ve desteği sonlandırılmış özellikler

  • JourneySharingMapView ve JourneySharingMapViewOptions işaretçi ve çoklu çizgi kurulum seçenekleri (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup ve diğerleri): Desteği sonlandırıldı. Değişiklik: Konum sağlayıcıda MarkerCustomizationFunction ve PolylineCustomizationFunction seçenekleri (ör. vehicleMarkerCustomization). Belirti: Gelecekteki bir sürümde kaldırılması planlanıyor. Geçiş rehberini inceleyin.
  • JourneySharingMapView.locationProvider ve JourneySharingMapViewOptions.locationProvider: Desteği sonlandırıldı. Değiştirme: JourneySharingMapView.locationProviders ve JourneySharingMapViewOptions.locationProviders.
  • JourneySharingMapView işaretçi ve çoklu çizgi listesi özellikleri (vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines ve görev işaretçisi özellikleri): Kullanımdan kaldırıldı. Değişiklik: Konum sağlayıcıda MarkerCustomizationFunction ve PolylineCustomizationFunction geri çağırmaları. Geçiş rehberini inceleyin.

JavaScript Tüketici SDK'sı ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.