Krótkie wprowadzenie do pakietu Driver SDK na iOS

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

Oficjalne pakiety Driver SDK na iOS:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

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 updateMask jest pusty. Rozwiązanie: zawsze podawaj co najmniej jedną nazwę pola w updateMask i obsługuj ten błąd w GMTDVehicleReporterListener didFailVehicleUpdate. Zobacz /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Problem: GMSRoadSnappedLocationProvider nie 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 uruchom GMSRoadSnappedLocationProvider (z GMTDVehicleReporter dodanym 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 do setDestinations() 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.
  • GMTSServiceType i fetchAuthTokenForServiceType:authorizationContext:completion:: wycofane 29 listopada 2021 r. Zastąpienie: GMTDAuthorization fetchTokenWithContext: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.