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-IDna 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 parametrzerelated_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: produkty powiązane
- Często używane z: Driver SDK na Androida, Driver SDK na iOS, Consumer SDK na Androida, Consumer SDK na iOS, JavaScript Consumer SDK, Route Optimization API
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_FOUNDpodczas 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_EXCEEDEDwystępują, gdy żądanie trwa dłużej niż domyślny limit czasu biblioteki klienta. Rozwiązanie: dostosuj ustawienia ponawiania RPC (np.setTotalTimeoutwVehicleServiceSettingsw 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łaniaReportBillableTrip. 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:UpdateVehiclewVehicleService. Symptom: wycofany 1 lutego 2024 r.; wyłączony w maju 2024 r. - Metoda
SearchFuzzedVehicles: wycofana 1 maja 2024 r. Wymiana:SearchVehicleswVehicleService. Symptom: wycofany 1 lutego 2024 r.; wyłączony w maju 2024 r. - Metoda
SearchTasks: wycofana 1 maja 2024 r. Wymiana:GetTaskTrackingInfow kraju:DeliveryService. Symptom: wycofany 1 lutego 2024 r.; wyłączony w maju 2024 r. ReportBillableTrippo 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 APIreportBillableEvent. 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.
- Raportowanie płatnego wykorzystania przejazdów w Fleet Engine.
- Utwórz i zwróć nowy przejazd we Fleet Engine.
- Zwracanie informacji o przejeździe w Fleet Engine.
- Zwraca listę wszystkich przejazdów Fleet Engine dla określonego pojazdu.
- Zaktualizuj dane przejazdu w Fleet Engine.
- Utwórz instancję nowego pojazdu w usłudze Fleet Engine powiązanej z dostawcą przejazdów lub dostaw na żądanie.
- Zwracanie pojazdu z usługi Fleet Engine.
- Zwraca podzieloną na strony listę pojazdów we Fleet Engine powiązanych z dostawcą, które spełniają określone kryteria.
- Zwraca listę pojazdów we Fleet Engine, które spełniają określone kryteria.
- Aktualizowanie danych pojazdu we Fleet Engine.
- Zaktualizuj atrybuty pojazdu we Fleet Engine.
- Zwracanie informacji o przejeździe pojazdu z usługi Fleet Engine.