Fleet Engine hizmeti hızlı referansı

Fleet Engine, gerçek dünyadaki araç filonuzu modelleyen ve isteğe bağlı geziler ile planlanmış görevler için rota, TVS, trafik ve durum güncellemeleri sağlayan bir arka uç hizmetidir. Sürücü SDK'sından alınan konum ve rota verilerini kullanır, Tüketici SDK'sı ve diğer Google Haritalar Platformu API'leriyle çalışır.

Fleet Engine hizmeti: Temel bilgiler

  • Ürün: Fleet Engine hizmeti
  • Diğer adları: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • Kategori: Rotalar
  • Platform: Web hizmeti (REST)
  • Çalıştığı yer: Sunucu (arka uç kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: Fleet Engine hizmetine genel bakış

Fleet Engine hizmeti: Ne zaman kullanılır?

Fleet Engine hizmetini şu durumlarda kullanın:

  • Araçları ve seç-izle gezileri (teslim alma, ara noktalar, bırakma) modelleyen bir arka uca ihtiyacınız vardır. Bu geziler arasında çok hedefli, arka arkaya veya paylaşımlı geziler de yer alır.
  • Araçlara atanan planlanmış teslimat veya hizmet görevlerini modellemeniz ve duraklarını, sonuçlarını ve TVS'lerini takip etmeniz gerekiyor.
  • Araçları istenen yolculuklarla eşleştirmek için bir bölgedeki araçları aramanız veya listelemeniz gerekir.
  • Tüketici gezisi veya gönderi takibi ve Driver SDK konum güncellemeleriyle desteklenen filo operatörü takibi gerekir.

Fleet Engine hizmetini aşağıdaki durumlarda kullanmayın:

  • Fleet Engine gezi veya görev düzenlemesi olmadan kendi veritabanınızdan ya da akışınızdan bir web haritasında canlı GPS işaretçileri veya öğe yolları göstermeniz gerekir. Bunun yerine Maps JavaScript API'yi kullanın.
  • Fleet Engine gezisi veya görev düzenlemesi olmadan bir Android uygulamasında kendi verilerinizden canlı işaretçiler veya yollar göstermeniz gerekir. Bunun yerine Android için Haritalar SDK'sını kullanın.
  • Fleet Engine gezi veya görev düzenlemesi olmadan, bir iOS uygulamasında kendi verilerinizden canlı işaretçiler veya rotalar göstermeniz gerekir. Bunun yerine iOS için Haritalar SDK'sını kullanın.
  • Filo genelinde optimize edilmiş rota planlarını hesaplamanız gerekir. Fleet Engine, yalnızca sağladığınız bir çözücüden rota planlarını alır. Bunun yerine Route Optimization API'yi kullanın.

Fleet Engine hizmeti: kurulum

  • Etkinleştirilecek hizmet: fleetengine.googleapis.com
  • Kimlik doğrulama: Hizmet hesabı, JSON Web Jetonu (JWT), OAuth 2.0
  • Kullanım ilişkilendirme: İsteğe bağlı beta özelliği: Mobility paketi hizmetlerine yapılan çağrılarda X-Goog-Maps-Experience-ID HTTP üstbilgisini Mobility İşlem Kimliği'ne (veya oturum kimliği gibi ilgili bir kimliğe) ayarlayın. Birden fazla kimliği virgülle ayırın. İşlemi bildirirken ilgili tüm kimlikleri related_ids içinde iletin.
  • Başlayın: Fleet Engine hizmetini ayarlama
  • Referans: Fleet Engine hizmet referansı
  • Politikalar: Fleet Engine hizmet politikaları
  • Sürüm notları: Fleet Engine hizmeti sürüm notları

Resmi Fleet Engine hizmet paketleri:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Fleet Engine hizmeti: Sık yapılan hatalar

  • Sorun: Fleet Engine'e gönderilen istekler zaman zaman başarısız olabilir ve başarısız bir istekten sonra araçlar gibi öğeler artık mevcut olmayabilir (güncelleme sırasında NOT_FOUND). Düzeltme: Geri çekilme ile yeniden denemeler uygulayın (istemci kitaplıkları varsayılan olarak yeniden dener) ve eksik araçları veya görevleri mevcut durumlarında yeniden oluşturun. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot sayfasını inceleyin.
  • Sorun: Bir istek, istemci kitaplığının varsayılan zaman aşımı süresinden daha uzun sürdüğünde DEADLINE_EXCEEDED hataları oluşur. Düzeltme: RPC yeniden deneme ayarlarını düzenleyin (ör. Java istemcisinde VehicleServiceSettings için setTotalTimeout). /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot sayfasını inceleyin.
  • Sorun: JWT'de doğru hak talepleri eksikse veya imzalama hizmeti hesabında gerekli Fleet Engine IAM rolü yoksa PERMISSION_DENIED (HTTP 403) (ör. "JWT, istenen gezi için eşleşen bir kapsam içermiyor"). Düzeltme: Hizmet hesabı rollerini kontrol edin ve JWT taleplerinin erişilen araç, gezi veya görev için kapsamları içerdiğinden emin olun. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot sayfasını inceleyin.
  • Sorun: On-Demand Rides and Deliveries'den herhangi bir Mobility paketine veya Last Mile Fleet Solution'dan Mobility Activate ya da Optimize'a geçiş yaparken Mobility Billing API istekleri, geçiş tamamlanana kadar HTTP 202 döndürür ve faturalandırmayla sonuçlanmaz. Düzeltme: Taşıma işleminden birkaç gün öncesinden birkaç gün sonrasına kadar hem Fleet Engine'ı ReportBillableTrip hem de Mobility Billing API'yi çağırın, Cloud Logging'deki istek sayılarını karşılaştırın ve ardından ReportBillableTrip çağrılarını kaldırın. /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration adresini ziyaret edin.

Fleet Engine hizmeti: eski ve desteği sonlandırılmış özellikler

  • UpdateVehicleLocation yöntemi: 01.05.2024 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: VehicleService içinde UpdateVehicle. Belirti: 01.02.2024'te desteği sonlandırıldı; Mayıs 2024'te kullanımdan kaldırıldı.
  • SearchFuzzedVehicles yöntemi: 01.05.2024 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: VehicleService içinde SearchVehicles. Belirti: 01.02.2024'te desteği sonlandırıldı; Mayıs 2024'te kullanımdan kaldırıldı.
  • SearchTasks yöntemi: 01.05.2024 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: DeliveryService içinde GetTaskTrackingInfo. Belirti: 01.02.2024'te desteği sonlandırıldı; Mayıs 2024'te kullanımdan kaldırıldı.
  • ReportBillableTrip Mobility paketine (On-Demand Rides and Deliveries'den herhangi bir pakete veya Last Mile Fleet Solution'dan Activate ya da Optimize'a) geçiş yaptıktan sonra: Eski. Değişiklik: Mobility Billing API reportBillableEvent. Belirti: Sözleşmeye özeldir, API desteğinin sonlandırılması değildir. Taşıma işleminden sonra çağrılar "Geçersiz Sözleşme: Bu proje [...] FleetEngine'i kullanma yetkisine sahip değil." hatasını döndürebilir. Geçiş rehberini inceleyin.

Fleet Engine hizmetiyle 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.