Pakiet Driver SDK na iOS to zestaw narzędzi do aplikacji mobilnych i komponent Fleet Engine. Wysyła z pakietu Navigation SDK do Fleet Engine lokalizację pojazdu, trasę, punkty orientacyjne, pozostałą odległość i szacowany czas dotarcia na miejsce w przypadku przejazdów na żądanie i zaplanowanych zadań.
Driver SDK na iOS: najważniejsze informacje
- Usługa: Driver SDK na iOS
- Inne nazwy: pakiet SDK dla kierowców, pakiet SDK dla kierowców do przejazdów na żądanie, pakiet SDK dla kierowców do zaplanowanych zadań
- Kategoria: Trasy
- Platforma: iOS
- Działa na: kliencie (kod aplikacji lub przeglądarki)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: omówienie pakietu Driver SDK na iOS
Pakiet SDK dla kierowców na iOS: kiedy go używać
Używaj pakietu Driver SDK na iOS, gdy:
- Aby wysyłać do Fleet Engine informacje o zmianie lokalizacji pojazdu w czasie rzeczywistym, potrzebujesz aplikacji dla kierowców na iOS.
- Musisz zgłosić do Fleet Engine trasę, punkty pośrednie, pozostałą odległość i szacowany czas dotarcia na miejsce z pakietu Navigation SDK.
- Kierowcy muszą mieć możliwość zarządzania przypisanymi przejazdami na żądanie i nawigowania w jednej aplikacji bez konieczności przełączania się między aplikacjami.
- Tworzysz aplikację dla kierowców na potrzeby zaplanowanych zadań Fleet Engine na iOS.
Nie używaj pakietu Driver SDK na iOS, gdy:
- Potrzebujesz tylko szczegółowych wskazówek dojazdu w aplikacji na iOS, bez śledzenia przez Fleet Engine. Zamiast tego użyj pakietu Navigation SDK na iOS.
- Musisz pokazać pasażerowi lub klientowi postęp przejazdu lub dostawy w aplikacji użytkownika. Użyj pakietu Consumer SDK na iOS.
- Musisz wysyłać aktualizacje danych pojazdu inne niż lokalizacja i trasa. Są one przesyłane przez backend do Fleet Engine. Zamiast tego użyj usługi Fleet Engine.
- Aplikacja kierowcy działa na Androidzie. Zamiast tego użyj pakietu Driver SDK na Androida.
Pakiet SDK dla kierowców na iOS: konfiguracja
- Uwierzytelnianie: klucz interfejsu API, token internetowy JSON (JWT)
- Włącz też: Maps SDK na iOS
- Pierwsze kroki: konfigurowanie pakietu Driver SDK na iOS
- Dokumentacja: Dokumentacja pakietu Driver SDK na iOS
- Zasady: Zasady dotyczące pakietu Driver SDK na iOS
- Informacje o wersji: informacje o wersji pakietu Driver SDK na iOS
Oficjalne pakiety Driver SDK na iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK na iOS: produkty powiązane
- Często używane z: Navigation SDK na iOS, usługą Fleet Engine, pakietem Consumer SDK na iOS
Pakiet SDK dla kierowców na iOS: typowe błędy
- Problem: pierwsza aktualizacja pojazdu po uruchomieniu może się nie powieść i wyświetlić komunikat „update_mask cannot be empty” (update_mask nie może być puste), gdy parametr
updateMaskjest pusty. Rozwiązanie: zawsze podawaj co najmniej jedną nazwę pola wupdateMaski obsługuj ten błąd wGMTDVehicleReporterListenerdidFailVehicleUpdate. Zobacz /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Problem:
GMSRoadSnappedLocationProvidernie wysyła informacji o zmianie lokalizacji, gdy urządzenie nie zmieniło położenia od ostatniej aktualizacji, np. gdy kierowca czeka na postoju. Rozwiązanie: aby wysłać nową informację o zmianie lokalizacji, gdy urządzenie jest nieruchome, zatrzymaj, a następnie uruchomGMSRoadSnappedLocationProvider(zGMTDVehicleReporterdodanym jako odbiorca). Zobacz /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - Problem: aplikacja użytkownika nie renderuje prawidłowo przejazdu, jeśli współrzędne przekazane do
setDestinations()nie pasują do punktu trasy przejazdu. Rozwiązanie: upewnij się, że szerokość i długość geograficzna przekazywane dosetDestinations()są zgodne ze współrzędnymi punktu na trasie przejazdu w Fleet Engine. Zobacz /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - Problem: użycie operatora wersji optymistycznej (
~>) może prowadzić do nieprzewidywalnych, niepowtarzalnych kompilacji, a pominięcie wersji powoduje wczytanie najnowszego pakietu SDK, który może zawierać zmiany powodujące niezgodność lub podwyższać minimalną wersję iOS. Carthage nie jest obsługiwany. Rozwiązanie: przypnij dokładną wersję pakietu Driver SDK w CocoaPods lub Swift Package Manager i sprawdź informacje o wersji przed uaktualnieniem. Zobacz /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
Pakiet SDK dla kierowców na iOS: funkcje starsze i wycofane
- Klasa
GMTSVehicleMatch: wycofana. Zamiennik: w pakiecie Driver SDK nie jest potrzebny żaden zamiennik (dopasowywanie pojazdów jest obsługiwane w Fleet Engine). Objaw: wycofano w pakiecie Driver SDK na iOS w wersji 2.2.0 i pominięto w bieżącej dokumentacji pakietu Driver SDK. Zobacz przewodnik po migracji. GMTSServiceTypeifetchAuthTokenForServiceType:authorizationContext:completion:: wycofane 29 listopada 2021 r. Zastąpienie:GMTDAuthorizationfetchTokenWithContext:completion:wartościąGMTDAuthorizationContext(tylko roszczenia dotyczące identyfikatora pojazdu). Zobacz przewodnik po migracji.
Możliwości pakietu Driver SDK na iOS
Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.
- Zgłaszanie pozycji pojazdu w czasie rzeczywistym do usługi Fleet Engine.
- Zgłaszanie współrzędnych szerokości i długości geograficznej punktów trasy przejazdu pojazdu z pakietu Navigation SDK do usługi Fleet Engine.
- Zgłaszanie do usługi Fleet Engine pozostałej odległości pojazdu do następnego punktu na trasie.
- Zgłaszanie do usługi Fleet Engine szacowanego czasu dotarcia pojazdu do następnego punktu na trasie.
- Zgłaszanie do usługi Fleet Engine trasy podanej dla pojazdu przez pakiet Navigation SDK.