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
- Kimlik doğrulama: API anahtarı, JSON Web Jetonu (JWT)
- Şunları da etkinleştirin: Maps JavaScript API, Fleet Engine Hizmeti
- Kullanım ilişkilendirmesi: İsteğe bağlı (beta) Mobilite İşlem Kimliği:
JourneySharingMapViewoluşturmadan öncegoogle.maps.Settings.getInstance().experienceIdsdeğerini bir Mobilite İşlem Kimliği (veya ilgili kimlikler) dizisi olarak ayarlayın.experienceIds, yalnızca Maps JavaScript API'ninv=betakanalında kullanılabilir. - Başlayın: JavaScript Tüketici SDK'sını ayarlama
- Referans: JavaScript Tüketici SDK'sı referansı
- Sürüm notları: JavaScript Tüketici SDK'sı sürüm notları
JavaScript Tüketici SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Fleet Engine hizmeti, Maps JavaScript API, Android için Driver SDK, iOS için Driver SDK
JavaScript Tüketici SDK'sı: Sık yapılan hatalar
- Sorun:
JourneySharingMapViewharitası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 sonramapView.map.setCenter(...)vemapView.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...catchbloklarına sarmalayın. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey adresini inceleyin. - Sorun:
journeySharingkitaplığını yüklemediğiniz sürecegoogle.maps.journeySharingsınıfları kullanılamaz. Düzeltme: Maps JavaScript API komut dosyası URL'sinelibraries=journeySharingekleyin 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
expiresInSecondsdöndüren birauthTokenFetchersağlayın. /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup adresini inceleyin.
JavaScript Consumer SDK: eski ve desteği sonlandırılmış özellikler
JourneySharingMapViewveJourneySharingMapViewOptionsişaretçi ve çoklu çizgi kurulum seçenekleri (vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupve diğerleri): Desteği sonlandırıldı. Değişiklik: Konum sağlayıcıdaMarkerCustomizationFunctionvePolylineCustomizationFunctionseçenekleri (ör.vehicleMarkerCustomization). Belirti: Gelecekteki bir sürümde kaldırılması planlanıyor. Geçiş rehberini inceleyin.JourneySharingMapView.locationProviderveJourneySharingMapViewOptions.locationProvider: Desteği sonlandırıldı. Değiştirme:JourneySharingMapView.locationProvidersveJourneySharingMapViewOptions.locationProviders.JourneySharingMapViewişaretçi ve çoklu çizgi listesi özellikleri (vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinesve görev işaretçisi özellikleri): Kullanımdan kaldırıldı. Değişiklik: Konum sağlayıcıdaMarkerCustomizationFunctionvePolylineCustomizationFunctiongeri ç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.
- Fleet Engine'den bir web sayfasındaki veya mobil uygulamadaki haritaya bir geziyi izleyen rota çoklu çizgisi ekleyin.
- Fleet Engine gezisi için bir web sayfasındaki veya mobil uygulamadaki haritada rota boyunca gezi ilerleme durumunu güncelleme
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen bir haritadaki yolların, çoklu çizgilerin ve poligonların stilini değiştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada harita özelliklerini gösterme veya gizleme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen haritadaki simgelerin ve metin etiketlerinin stilini değiştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada farklı yakınlaştırma seviyelerine farklı harita stilleri uygulayın.
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen haritadaki yerlerin yoğunluğunu değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği GA'dır. ÖY yoğunluk kontrolü ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen haritadaki binaların stilini değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği genel kullanıma sunulmuştur. 3D ve bina taban alanı stil özelleştirmesi ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen bir haritadaki önemli noktaların stilini değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği genel kullanıma sunulmuştur. Önemli nokta simgesi özelleştirme ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'den bir seyahatin ilerleme durumunu izleyen bir haritadaki işaretçiyi özelleştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada rota çoklu çizgisini özelleştirme