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
- Uwierzytelnianie: token internetowy JSON (JWT)
- Włącz też: Fleet Engine Service.
- Pierwsze kroki: skonfiguruj pakiet SDK dla konsumentów na iOS
- Dokumentacja: dokumentacja pakietu SDK dla konsumentów na iOS
- Zasady: Zasady dotyczące pakietu SDK dla klientów na iOS
- Informacje o wersji: informacje o wersji pakietu SDK dla konsumentów na iOS
Oficjalne pakiety Consumer SDK na iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK na iOS: produkty powiązane
- Często używane z: Fleet Engine Service, Driver SDK na iOS, Driver SDK na Androida, Maps SDK na iOS
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 formacieproviders/{provider_id}/trips/{trip_id}. Rozwiązanie: użyj identyfikatora projektu Google Cloud jakoprovider_idi przekaż ten sam identyfikator projektu jakoproviderIDpodczas 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
unregisterSubscriberw 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.bundleiGoogleRidesharingConsumer.bundle, połącz wymienione platformy i dodaj-ObjCdo 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:naGMTSVehicleLocationOptions.[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.
- Dodaj do aplikacji mobilnej dostosowywaną, interaktywną mapę, która śledzi postęp przejazdu z Fleet Engine.
- Dodaj linię łamaną trasy, która śledzi przejazd z Fleet Engine, do mapy na stronie internetowej lub w aplikacji mobilnej.
- Aktualizowanie postępów przejazdu na trasie na mapie na stronie internetowej lub w aplikacji mobilnej w przypadku przejazdu w Fleet Engine.
- Zmień styl dróg, linii łamanych i wielokątów na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Wyświetlanie lub ukrywanie obiektów na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Zmienianie stylu ikon i etykiet tekstowych na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Zastosuj różne style mapy do różnych poziomów powiększenia na mapie, która śledzi postęp przejazdu z silnika floty.
- Zmienianie gęstości miejsc na mapie, która śledzi postęp przejazdu z Fleet Engine. Eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie SDK dla konsumentów jest ogólnie dostępna, natomiast kontrola gęstości ciekawych miejsc to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Zmień styl budynków na mapie, która śledzi postęp podróży z Fleet Engine. Wersja eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie Consumer SDK jest ogólnie dostępna, natomiast dostosowywanie stylu budynków 3D i ich obrysów to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Zmienianie stylu punktów orientacyjnych na mapie, która śledzi postęp przejazdu z Fleet Engine. Eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie SDK dla klientów jest ogólnie dostępna, natomiast dostosowywanie ikon punktów orientacyjnych to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Dostosuj znacznik na mapie, który śledzi postęp przejazdu z Fleet Engine.
- Dostosuj linię łamaną trasy na mapie, która śledzi postęp przejazdu z Fleet Engine.