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

Le SDK Driver pour iOS est un kit d'outils pour applications mobiles et un composant de Fleet Engine. Il envoie la position du véhicule, l'itinéraire, les points de cheminement, la distance restante et l'heure d'arrivée prévue d'une application de chauffeur depuis le SDK Navigation vers Fleet Engine, pour les trajets à la demande et les tâches planifiées.

SDK Driver pour iOS : informations clés

  • Produit : SDK Driver pour iOS
  • Également appelé : SDK Driver, SDK Driver pour les trajets à la demande, SDK Driver pour les tâches planifiées
  • 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 Driver pour iOS

SDK Driver pour iOS : quand l'utiliser

Utilisez le SDK Driver pour iOS dans les cas suivants :

  • Vous avez besoin d'une application de chauffeur iOS pour envoyer des mises à jour de la position du véhicule en temps réel à Fleet Engine.
  • Vous devez signaler l'itinéraire, les points de cheminement, la distance restante et l'heure d'arrivée prévue du SDK Navigation à Fleet Engine.
  • Vous avez besoin de chauffeurs pour gérer les trajets à la demande attribués et naviguer dans une seule application sans changer d'application.
  • Vous créez une application de chauffeur pour les tâches planifiées Fleet Engine sur iOS.

N'utilisez pas le SDK Driver pour iOS dans les cas suivants :

  • Vous n'avez besoin que de la navigation détaillée dans votre application iOS, sans le suivi Fleet Engine. Utilisez plutôt le SDK Navigation pour iOS.
  • Vous devez afficher la progression du trajet ou de la livraison pour le passager ou le client dans une application grand public. Utilisez plutôt le SDK Consumer pour iOS.
  • Vous devez envoyer des mises à jour des données du véhicule autres que la position et l'itinéraire. Elles transitent par votre backend vers Fleet Engine. Utilisez plutôt le service Fleet Engine.
  • Votre application de chauffeur s'exécute sur Android. Utilisez plutôt le SDK Driver pour Android.

SDK Driver pour iOS : configuration

Packages officiels du SDK Driver pour iOS :

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

SDK Driver pour iOS : erreurs courantes

  • Problème : La première mise à jour du véhicule après le démarrage peut échouer avec l'erreur "update_mask cannot be empty" (update_mask ne peut pas être vide) lorsque le paramètre updateMask est vide. Correction : Indiquez toujours au moins un nom de champ dans updateMask et gérez cette erreur dans GMTDVehicleReporterListener didFailVehicleUpdate. Consultez /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Problème : GMSRoadSnappedLocationProvider n'envoie pas de mises à jour de position lorsque l'appareil n'a pas bougé depuis la dernière mise à jour, par exemple lorsqu'un conducteur attend sans bouger. Correction : Pour envoyer une nouvelle notification de position lorsque l'appareil est immobile, arrêtez puis démarrez GMSRoadSnappedLocationProvider (avec GMTDVehicleReporter déjà ajouté en tant qu'écouteur). Consultez /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready.
  • Problème : L'application grand public n'affiche pas correctement le trajet si les coordonnées transmises à setDestinations() ne correspondent pas au point de cheminement du trajet. Correction : Assurez-vous que la latitude/longitude transmise à setDestinations() correspond aux coordonnées du point de cheminement du trajet dans Fleet Engine. Consultez /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details.
  • Problème : L'utilisation d'un opérateur de version optimiste (~>) peut entraîner des builds imprévisibles et non reproductibles. De plus, l'omission d'une version charge le SDK le plus récent, ce qui peut inclure des modifications destructives ou augmenter la version minimale d'iOS. Carthage n'est pas compatible. Correction : Épinglez une version exacte du SDK Driver dans CocoaPods ou Swift Package Manager, et consultez les notes de version avant de procéder à la mise à niveau. Consultez /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.

SDK Driver pour iOS : fonctionnalités anciennes et obsolètes

  • Classe GMTSVehicleMatch : obsolète. Remplacement : aucun remplacement n'est nécessaire dans le SDK Driver (la mise en correspondance des véhicules est gérée dans Fleet Engine). Symptôme : Obsolète dans le SDK Driver pour iOS v2.2.0 et omis dans la documentation de référence actuelle du SDK Driver. Consultez le guide de migration.
  • GMTSServiceType et fetchAuthTokenForServiceType:authorizationContext:completion: : obsolètes depuis le 29/11/2021. Remplacement : GMTDAuthorization fetchTokenWithContext:completion: par GMTDAuthorizationContext (revendications pour l'ID du véhicule uniquement). Consultez le guide de migration.

Ce que vous pouvez faire avec le SDK Driver pour iOS

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.