Le SDK client pour iOS permet aux applications grand public iOS de suivre les trajets à la demande dans Fleet Engine. Ses classes, telles que GMTCTripModel et GMTCJourneySharingSession, modélisent les données de trajet et affichent la position du véhicule, l'itinéraire, l'heure d'arrivée prévue et la distance restante sur une carte.
SDK Consumer pour iOS : informations clés
- Produit : SDK client pour iOS
- Également appelé : SDK client iOS
- Catégorie : Routes
- Plate-forme : iOS
- Exécution sur : client (code de l'application ou du navigateur)
- Étape de lancement : GA
- Cycle de vie : Actif
- Présentation : Présentation du SDK client pour iOS
SDK Consumer pour iOS : quand l'utiliser
Utilisez le SDK Consumer pour iOS dans les cas suivants :
- Vous devez disposer d'une application iOS dans laquelle les consommateurs suivent un trajet à la demande ou une livraison suivis par Fleet Engine.
- Vous devez afficher la position en temps quasi réel d'un véhicule, son itinéraire et le trafic en temps réel sur une carte dans une application iOS grand public.
- Vous devez afficher l'heure d'arrivée prévue pour la prise en charge et la dépose, ainsi que la distance restante pour un trajet à la demande dans iOS.
- Vous utilisez déjà Fleet Engine et le SDK Driver pour les trajets à la demande, et vous avez besoin de la partie consommateur du partage de trajet.
Ne pas utiliser le SDK Consumer pour iOS dans les cas suivants :
- Vous avez besoin que les consommateurs suivent les tâches ou les livraisons planifiées. L'expérience client des tâches planifiées est documentée pour JavaScript. Utilisez plutôt le SDK JavaScript Consumer.
- Vous devez partager la progression d'un trajet à la demande dans une application grand public Android. Utilisez plutôt le SDK Consumer pour Android.
- Vous devez partager la progression d'un trajet à la demande dans une application Web. Utilisez plutôt le SDK JavaScript Consumer.
- Vous devez envoyer la position du conducteur et l'état du trajet depuis l'application iOS du conducteur vers Fleet Engine. Utilisez plutôt le SDK Driver pour iOS.
SDK Consumer pour iOS : configuration
- Authentification : jeton Web JSON (JWT)
- Activez également : Service Fleet Engine
- Premiers pas : Configurer le SDK client pour iOS
- Documentation de référence : Documentation de référence du SDK Consumer pour iOS
- Règles : Règles du SDK Consumer pour iOS
- Notes de version : Notes de version du SDK Consumer pour iOS
Packages officiels du SDK Consumer pour iOS :
- cocoapods :
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
SDK client pour iOS : produits associés
- Souvent utilisé avec : service Fleet Engine, SDK Driver pour iOS, SDK Driver pour Android, SDK Maps pour iOS
SDK Consumer pour iOS : erreurs courantes
- Problème : Le suivi du trajet échoue avec l'erreur 401
UNAUTHENTICATEDlorsque le jeton JWT est signé sans ID de trajet ou qu'il a expiré. Solution : Demandez à votre fournisseur de jetons (GMTCAuthorization) de renvoyer un jeton JWT émis pour l'ID du trajet dans le contexte d'autorisation, de le mettre en cache pour chaque trajet et de l'actualiser lorsqu'il expire. Voir /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk. - Problème : Le suivi du trajet échoue avec l'erreur 400
INVALID_ARGUMENTlorsque le nom du trajet n'utilise pas le formatproviders/{provider_id}/trips/{trip_id}. Correction : Utilisez l'ID du projet Google Cloud commeprovider_idet transmettez le même ID de projet queproviderIDlorsque vous initialisez le SDK. Consultez /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk. - Problème : l'application continue d'écouter les mises à jour une fois qu'un trajet est terminé ou annulé. Correction : Appelez
unregisterSubscribersur le modèle de trajet lorsque le trajet se termine ou est annulé. Consultez /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey. - Problème : Les installations manuelles de XCFramework omettent les bundles de ressources et les paramètres de compilation requis, sauf si vous les ajoutez dans Xcode. Solution : utilisez CocoaPods lorsque vous le pouvez. Pour les installations manuelles, ajoutez
gRPCCertificates.bundleetGoogleRidesharingConsumer.bundleau projet, associez les frameworks listés et ajoutez-ObjCà "Other Linker Flags" (Autres indicateurs d'association) pour le débogage et la publication. Consultez /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.
SDK Consumer pour iOS : fonctionnalités anciennes et obsolètes
- Initialiseur
GMTSVehicleLocation-initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: obsolète depuis le 01/06/2025. Remplacement :GMTSVehicleLocation-initWithOptions:parGMTSVehicleLocationOptions. [GMTCMapView initWithCoder]: Obsolète depuis le 01/12/2023. Remplacement :GMTCMapView-initWithOptions:.
Ce que vous pouvez faire avec le SDK Consumer pour iOS
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
- Ajoutez une carte interactive personnalisable qui suit la progression d'un trajet de Fleet Engine vers une application mobile.
- Ajoutez une polyligne d'itinéraire qui suit un trajet de Fleet Engine à une carte sur une page Web ou une application mobile.
- Mettez à jour la progression d'un trajet Fleet Engine sur un itinéraire dans une carte sur une page Web ou une application mobile.
- Modifiez le style des routes, des polylignes et des polygones sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Afficher ou masquer les éléments cartographiques sur une carte qui suit la progression d'un trajet depuis Fleet Engine
- Modifiez le style des icônes et des libellés de texte sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Appliquez différents styles de carte à différents niveaux de zoom sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Modifiez la densité des lieux sur une carte qui suit la progression d'un trajet depuis Fleet Engine. Expérimental Remarque : La prise en charge des styles de cartes basés dans le cloud dans le SDK client est en disponibilité générale, tandis que le contrôle de la densité des points d'intérêt est une fonctionnalité expérimentale des styles de cartes basés dans le cloud (compatible uniquement avec les styles de cartes clairs).
- Modifiez le style des bâtiments sur une carte qui suit la progression d'un trajet depuis Fleet Engine. Expérimental Remarque : La compatibilité avec les styles de cartes basés dans le cloud dans le SDK Consumer est en disponibilité générale, tandis que la personnalisation des styles de bâtiments en 3D et d'empreintes est une fonctionnalité expérimentale des styles de cartes basés dans le cloud (compatible uniquement avec les styles de cartes clairs).
- Modifiez le style des points de repère sur une carte qui suit la progression d'un trajet depuis Fleet Engine. Expérimental Remarque : La prise en charge des styles de cartes basés dans le cloud dans le SDK Consumer est en disponibilité générale, tandis que la personnalisation des icônes de repères est une fonctionnalité expérimentale des styles de cartes basés dans le cloud (compatible uniquement avec les styles de cartes clairs).
- Personnalisez un repère sur une carte qui suit la progression d'un trajet depuis Fleet Engine.
- Personnalisez la polyligne d'itinéraire sur une carte qui suit la progression d'un trajet depuis Fleet Engine.