Krótkie wprowadzenie do pakietu Consumer SDK na iOS

Pakiet SDK dla użytkowników na iOS umożliwia aplikacjom użytkownika na iOS śledzenie przejazdów na żądanie we Fleet Engine. Klasy takie jak GMTCTripModel i GMTCJourneySharingSession modelują dane o podróży i wyświetlają na mapie lokalizację pojazdu, trasę, szacowany czas dotarcia na miejsce i pozostałą odległość.

Pakiet SDK dla konsumentów na iOS: najważniejsze informacje

  • Usługa: pakiet SDK dla konsumentów na iOS
  • Inna nazwa: pakiet SDK dla konsumentów na iOS
  • Kategoria: Trasy
  • Platforma: iOS
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu Consumer SDK na iOS

Consumer SDK na iOS: kiedy warto z niego korzystać

Kiedy używać pakietu SDK dla konsumentów na iOS:

  • Potrzebujesz aplikacji na iOS, w której klienci mogą śledzić przejazd lub dostawę na żądanie, które są monitorowane przez Fleet Engine.
  • Musisz wyświetlić na mapie w aplikacji konsumenckiej na iOS lokalizację pojazdu w czasie zbliżonym do rzeczywistego, trasę i natężenie ruchu na żywo.
  • Musisz wyświetlić szacowany czas dotarcia na miejsce odbioru i wysiadki oraz pozostałą odległość w przypadku przejazdu na żądanie w iOS.
  • Korzystasz już z Fleet Engine i pakietu SDK sterowników do przejazdów na żądanie i potrzebujesz udostępniania przejazdu po stronie klienta.

Kiedy nie używać pakietu SDK dla konsumentów na iOS:

  • Potrzebujesz, aby konsumenci śledzili zaplanowane zadania lub dostawy. Środowisko konsumenta zaplanowanych zadań jest udokumentowane w przypadku JavaScriptu. Zamiast tego użyj pakietu SDK klienta JavaScript.
  • Musisz udostępniać postępy przejazdu na żądanie w aplikacji użytkownika na Androida. Zamiast tego użyj pakietu SDK dla konsumentów na Androida.
  • Musisz udostępniać postępy przejazdu na żądanie w aplikacji internetowej. Zamiast tego użyj pakietu SDK klienta JavaScript.
  • Musisz wysłać lokalizację kierowcy i stan przejazdu z aplikacji kierowcy na iOS do Fleet Engine. Zamiast tego użyj pakietu Driver SDK na iOS.

Pakiet SDK dla konsumentów na iOS: konfiguracja

Oficjalne pakiety Consumer SDK na iOS:

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

Pakiet SDK dla konsumentów na iOS: typowe błędy

  • Problem: monitorowanie przejazdu kończy się błędem 401 UNAUTHENTICATED, gdy token JWT jest podpisany bez identyfikatora przejazdu lub wygasł. Rozwiązanie: poproś dostawcę tokena (GMTCAuthorization), aby zwrócił token JWT wydany dla identyfikatora przejazdu w kontekście autoryzacji, zapisz go w pamięci podręcznej dla każdego przejazdu i odśwież, gdy wygaśnie. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • Problem: monitorowanie przejazdu kończy się błędem 400 INVALID_ARGUMENT, gdy nazwa przejazdu nie jest w formacie providers/{provider_id}/trips/{trip_id}. Rozwiązanie: użyj identyfikatora projektu Google Cloud jako provider_id i przekaż ten sam identyfikator projektu jako providerID podczas inicjowania pakietu SDK. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • Problem: aplikacja nadal nasłuchuje aktualizacji po zakończeniu lub anulowaniu przejazdu. Rozwiązanie: wywołaj unregisterSubscriber w modelu przejazdu, gdy przejazd zostanie zakończony lub anulowany. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • Problem: ręczne instalacje XCFramework pomijają wymagane pakiety zasobów i ustawienia kompilacji, chyba że dodasz je w Xcode. Rozwiązanie: w miarę możliwości używaj CocoaPods. W przypadku instalacji ręcznych dodaj do projektu gRPCCertificates.bundle i GoogleRidesharingConsumer.bundle, połącz wymienione platformy i dodaj -ObjC do innych flag łączących na potrzeby debugowania i wydania. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

Pakiet SDK Consumer na iOS: starsze i wycofane funkcje

  • GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute: initializer: wycofany od 1 czerwca 2025 r. Zamiennik: GMTSVehicleLocation -initWithOptions: na GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: wycofany 1 grudnia 2023 r. Wymiana: GMTCMapView -initWithOptions:.

Co można zrobić za pomocą pakietu Consumer 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.