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
- Autenticación: Token web JSON (JWT)
- También habilita el servicio de Fleet Engine.
- Comienza: Configura el SDK de consumidor para iOS
- Referencia: Referencia del SDK de consumidores para iOS
- Políticas: Políticas del SDK de consumidores para iOS
- Notas de la versión: Notas de la versión del SDK de Consumer para iOS
Paquetes oficiales del SDK de Consumer para iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
SDK de consumidor para iOS: Productos relacionados
- Se suele usar con: Servicio de Fleet Engine, SDK de Driver para iOS, SDK de Driver para Android, SDK de Maps para iOS
SDK de Consumer para iOS: Errores comunes
- Problema: La supervisión de viajes falla con el error 401
UNAUTHENTICATEDcuando 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_ARGUMENTcuando el nombre del viaje no usa el formatoproviders/{provider_id}/trips/{trip_id}. Solución: Usa el ID del proyecto de Google Cloud comoprovider_idy pasa el mismo ID del proyecto comoproviderIDcuando 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
unregisterSubscriberen 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.bundleyGoogleRidesharingConsumer.bundleal proyecto, vincula los frameworks que se indican y agrega-ObjCa 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:porGMTSVehicleLocationOptions. [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.
- Agrega un mapa interactivo y personalizable que haga un seguimiento del progreso de un viaje desde Fleet Engine hasta una app para dispositivos móviles.
- Agrega una polilínea de ruta que haga un seguimiento de un viaje desde Fleet Engine hasta un mapa en una página web o app para dispositivos móviles.
- Actualiza el progreso de un viaje de Fleet Engine en una ruta en un mapa de una página web o una app para dispositivos móviles.
- Cambia el estilo de las rutas, las polilíneas y los polígonos en un mapa que hace un seguimiento del progreso de un viaje de Fleet Engine.
- Oculta o muestra componentes de un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine.
- Cambia el estilo de los íconos y las etiquetas de texto en un mapa que hace un seguimiento del progreso de un viaje de Fleet Engine.
- Aplica diferentes diseños de mapa a diferentes niveles de zoom en un mapa que hace un seguimiento del progreso de un viaje de Fleet Engine.
- Cambia la densidad de los lugares en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine. Experimental Nota: La compatibilidad con el diseño de mapas basado en Cloud en el SDK para consumidores tiene DG, mientras que el control de densidad de los lugares de interés es una función experimental del diseño de mapas basado en Cloud (solo se admite en los diseños de mapas claros).
- Cambia el estilo de los edificios en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine. Experimental Nota: La compatibilidad con el diseño de mapas basado en Cloud en el SDK para consumidores tiene DG, mientras que la personalización del diseño de edificios en 3D y de huellas es una función experimental del diseño de mapas basado en Cloud (solo se admite en los diseños de mapas claros).
- Cambiar el estilo de los puntos de referencia en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine Experimental Nota: La compatibilidad con el diseño de mapas basado en Cloud en el SDK de consumidor tiene DG, mientras que la personalización de íconos de puntos de referencia es una función experimental del diseño de mapas basado en Cloud (solo se admite en los diseños de mapas claros).
- Personaliza un marcador en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine.
- Personaliza la polilínea de la ruta en un mapa que hace un seguimiento del progreso de un viaje desde Fleet Engine.