Referencia rápida del SDK de Consumer para iOS

El SDK de consumidor para iOS permite que las apps para consumidores de iOS sigan los viajes on demand en Fleet Engine. Sus clases, como GMTCTripModel y GMTCJourneySharingSession, modelan los datos de viaje y muestran la ubicación, la ruta, la hora estimada de llegada y la distancia restante del vehículo en un mapa.

SDK de consumidores para iOS: Datos clave

  • Producto: SDK de consumidor para iOS
  • También conocido como: SDK de consumidores para iOS
  • Categoría: Rutas
  • Plataforma: iOS
  • Se ejecuta en: El cliente (código de la app o del navegador)
  • Etapa de lanzamiento: GA
  • Ciclo de vida: Activo
  • Descripción general: Descripción general del SDK de Consumer para iOS

Cuándo usar el SDK de consumidor para iOS

Usa el SDK de Consumer para iOS en los siguientes casos:

  • Necesitas una app para iOS en la que los consumidores sigan un viaje de entrega o transporte on demand del que Fleet Engine haga un seguimiento.
  • Debes mostrar la ubicación en tiempo real, la ruta y el tráfico en vivo de un vehículo en un mapa en una aplicación para consumidores de iOS.
  • Debes mostrar la hora estimada de llegada de la recogida y la entrega, y la distancia restante para un viaje on demand en iOS.
  • Ya usas Fleet Engine y el SDK de Driver para viajes on demand, y necesitas el lado del consumidor del uso compartido del recorrido.

No uses el SDK de consumidor para iOS en los siguientes casos:

  • Necesitas que los consumidores sigan las tareas o los envíos programados. La experiencia del consumidor de tareas programadas está documentada para JavaScript. En su lugar, usa el SDK de consumidor para JavaScript.
  • Debes compartir el progreso de un viaje on demand en una aplicación para consumidores de Android. En su lugar, usa el SDK de consumidor para Android.
  • Necesitas compartir el progreso de un viaje on demand en una app web. En su lugar, usa el SDK de JavaScript para consumidores.
  • Debes enviar la ubicación del conductor y el estado del viaje desde la app para iOS del conductor a Fleet Engine. En su lugar, usa el SDK de Driver para iOS.

SDK de consumidor para iOS: Configuración

Paquetes oficiales del SDK de Consumer para iOS:

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

SDK de Consumer para iOS: Errores comunes

  • Problema: La supervisión de viajes falla con el error 401 UNAUTHENTICATED cuando el JWT se firma sin un ID de viaje o venció. Solución: Haz que tu proveedor de tokens (GMTCAuthorization) devuelva un JWT emitido para el ID del viaje en el contexto de autorización, lo almacene en caché por viaje y lo actualice cuando venza. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • Problema: La supervisión de viajes falla con el error 400 INVALID_ARGUMENT cuando el nombre del viaje no usa el formato providers/{provider_id}/trips/{trip_id}. Solución: Usa el ID del proyecto de Google Cloud como provider_id y pasa el mismo ID del proyecto como providerID cuando inicialices el SDK. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • Problema: La app sigue escuchando actualizaciones después de que se completa o cancela un viaje. Solución: Llama a unregisterSubscriber en el modelo de viaje cuando este se complete o se cancele. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • Problema: Las instalaciones manuales de XCFramework omiten los paquetes de recursos y los parámetros de configuración de compilación obligatorios, a menos que los agregues en Xcode. Solución: Usa CocoaPods siempre que sea posible. En el caso de las instalaciones manuales, agrega gRPCCertificates.bundle y GoogleRidesharingConsumer.bundle al proyecto, vincula los frameworks que se indican y agrega -ObjC a Other Linker Flags para la depuración y el lanzamiento. Consulta /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

SDK para consumidores para iOS: Funciones heredadas y obsoletas

  • Inicializador GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: Obsoleto desde el 1 de junio de 2025. Reemplazo: GMTSVehicleLocation -initWithOptions: por GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: Obsoleto desde el 1 de diciembre de 2023. Reemplazo: GMTCMapView -initWithOptions:.

Qué puedes hacer con el SDK de consumidor para iOS

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.