Guide de référence rapide du SDK client pour iOS

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

Packages officiels du SDK Consumer pour iOS :

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

SDK Consumer pour iOS : erreurs courantes

  • Problème : Le suivi du trajet échoue avec l'erreur 401 UNAUTHENTICATED lorsque 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_ARGUMENT lorsque le nom du trajet n'utilise pas le format providers/{provider_id}/trips/{trip_id}. Correction : Utilisez l'ID du projet Google Cloud comme provider_id et transmettez le même ID de projet que providerID lorsque 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 unregisterSubscriber sur 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.bundle et GoogleRidesharingConsumer.bundle au 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: par GMTSVehicleLocationOptions.
  • [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.