Krótkie omówienie usługi Fleet Engine

Fleet Engine to usługa backendu, która modeluje rzeczywistą flotę pojazdów i zapewnia informacje o trasie, szacowanym czasie dotarcia na miejsce, natężeniu ruchu i stanie przejazdów na żądanie oraz zaplanowanych zadań. Wykorzystuje dane o lokalizacji i trasie z pakietu Driver SDK oraz współpracuje z pakietem Consumer SDK i innymi interfejsami API Google Maps Platform.

Usługa Fleet Engine: najważniejsze informacje

  • Usługa: Fleet Engine Service
  • Inne nazwy: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • Kategoria: Trasy
  • Platforma: usługa internetowa (REST)
  • Działa na: serwerze (kod backendu)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie usługi Fleet Engine

Fleet Engine Service: kiedy używać

Kiedy używać usługi Fleet Engine:

  • Potrzebujesz backendu, który modeluje pojazdy i przejazdy na żądanie (odbiór, punkty orientacyjne, wysiadanie), w tym przejazdy z wieloma miejscami docelowymi, przejazdy jeden po drugim lub przejazdy współdzielone.
  • Musisz modelować zaplanowane zadania dostawy lub usługi przypisane do pojazdów oraz śledzić ich przystanki, wyniki i szacowany czas dotarcia na miejsce.
  • Aby dopasować pojazdy do żądanych przejazdów, musisz wyszukać lub wyświetlić listę pojazdów w danym regionie.
  • Potrzebujesz śledzenia przejazdów lub dostaw konsumentów oraz śledzenia operatorów floty na podstawie informacji o zmianie lokalizacji z pakietu Driver SDK.

Nie używaj usługi Fleet Engine, gdy:

  • Musisz wyświetlać znaczniki GPS na żywo lub ścieżki zasobów na mapie internetowej z własnej bazy danych lub strumienia, bez koordynacji przejazdów lub zadań przez Fleet Engine. Zamiast tego użyj Maps JavaScript API.
  • Chcesz wyświetlać znaczniki lub ścieżki na żywo na podstawie własnych danych w aplikacji na Androida bez korzystania z organizacji przejazdów lub zadań przez Fleet Engine. Zamiast tego użyj Maps SDK na Androida.
  • Musisz wyświetlać znaczniki lub ścieżki na żywo na podstawie własnych danych w aplikacji na iOS bez koordynacji przejazdów lub zadań przez Fleet Engine. Zamiast tego użyj Maps SDK na iOS.
  • Musisz obliczyć zoptymalizowane plany tras dla całej floty. Fleet Engine przyjmuje tylko plany tras z podanego przez Ciebie solvera. Zamiast tego użyj interfejsu Route Optimization API.

Usługa Fleet Engine: konfiguracja

  • Usługa do włączenia: fleetengine.googleapis.com
  • Uwierzytelnianie: konto usługi, token internetowy JSON (JWT), OAuth 2.0
  • Atrybucja wykorzystania: opcjonalna funkcja beta: ustaw nagłówek HTTP X-Goog-Maps-Experience-ID na identyfikator transakcji mobilności (lub powiązany identyfikator, np. identyfikator sesji) w wywołaniach usług pakietu mobilności. Rozdzielaj identyfikatory przecinkami. Podczas raportowania transakcji przekaż wszystkie powiązane identyfikatory w parametrze related_ids.
  • Pierwsze kroki: Konfigurowanie usługi Fleet Engine
  • Dokumentacja: dokumentacja usługi Fleet Engine
  • Zasady: Zasady usługi Fleet Engine
  • Informacje o wersjach: Informacje o wersjach usługi Fleet Engine

Oficjalne pakiety usługi Fleet Engine:

  • 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

Usługa Fleet Engine: typowe błędy

  • Problem: żądania wysyłane do Fleet Engine mogą czasami kończyć się niepowodzeniem, a po niepowodzeniu encje takie jak pojazdy mogą już nie istnieć (NOT_FOUND podczas aktualizacji). Rozwiązanie: zaimplementuj ponowne próby z wycofaniem (biblioteki klienta domyślnie ponawiają próby) i ponownie utwórz brakujące pojazdy lub zadania w ich bieżącym stanie. Zobacz /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problem: błędy DEADLINE_EXCEEDED występują, gdy żądanie trwa dłużej niż domyślny limit czasu biblioteki klienta. Rozwiązanie: dostosuj ustawienia ponawiania RPC (np. setTotalTimeout w VehicleServiceSettings w kliencie Java). Zobacz /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problem: PERMISSION_DENIED (HTTP 403), gdy w tokenie JWT brakuje prawidłowych deklaracji lub konto usługi podpisywania nie ma wymaganej roli uprawnień Fleet Engine (np. „JWT does not contain a matching scope for requested trip”). Rozwiązanie: sprawdź role konta usługi i upewnij się, że oświadczenia JWT obejmują zakresy dla pojazdu, przejazdu lub zadania, do którego uzyskiwany jest dostęp. Zobacz /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problem: podczas migracji z usługi Przejazdy i dostawy na żądanie do dowolnego pakietu Mobility lub z rozwiązania ostatniej mili do Mobility Activate lub Optimize żądania do interfejsu Mobility Billing API zwracają kod HTTP 202, dopóki migracja nie zostanie zakończona, i nie powodują naliczania opłat. Rozwiązanie: wywołuj zarówno ReportBillableTrip, jak i interfejs Mobility Billing API od kilku dni przed migracją do kilku dni po niej, porównaj liczbę żądań w Cloud Logging, a następnie usuń wywołania ReportBillableTrip. Zobacz /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Usługa Fleet Engine: starsze i wycofane funkcje

  • Metoda UpdateVehicleLocation: wycofana 1 maja 2024 r. Wymiana: UpdateVehicle w VehicleService. Symptom: wycofany 1 lutego 2024 r.; wyłączony w maju 2024 r.
  • Metoda SearchFuzzedVehicles: wycofana 1 maja 2024 r. Wymiana: SearchVehicles w VehicleService. Symptom: wycofany 1 lutego 2024 r.; wyłączony w maju 2024 r.
  • Metoda SearchTasks: wycofana 1 maja 2024 r. Wymiana: GetTaskTrackingInfo w kraju: DeliveryService. Symptom: wycofany 1 lutego 2024 r.; wyłączony w maju 2024 r.
  • ReportBillableTrip po przejściu na pakiet Mobility (Przejazdy i dostawy na żądanie na dowolny pakiet lub Rozwiązanie ostatniej mili na Activate lub Optimize): Legacy. Zastąpienie: Mobility Billing API reportBillableEvent. Objaw: dotyczy umowy, a nie wycofania interfejsu API. Po migracji wywołania mogą zwracać błąd „Nieprawidłowa umowa: ten projekt […] nie ma uprawnień do korzystania z FleetEngine”. Zobacz przewodnik po migracji.

Co możesz zrobić za pomocą usługi Fleet Engine

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.