El SDK de Driver para iOS es un kit de herramientas de apps para dispositivos móviles y un componente de Fleet Engine. Envía la ubicación del vehículo, la ruta, los puntos de referencia, la distancia restante y la hora estimada de llegada de la app para conductores desde el SDK de Navigation a Fleet Engine para los viajes on demand y las tareas programadas.
SDK de Driver para iOS: Datos clave
- Producto: SDK de Driver para iOS
- También conocido como: SDK de Driver, SDK de Driver para viajes on demand, SDK de Driver para tareas programadas
- 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 Driver para iOS
Cuándo usar el SDK de Driver para iOS
Usa el SDK de Driver para iOS en los siguientes casos:
- Necesitas una app para conductores de iOS para enviar actualizaciones de la ubicación de los vehículos en tiempo real a Fleet Engine.
- Debes informar la ruta, los puntos de referencia, la distancia restante y la hora estimada de llegada del SDK de Navigation a Fleet Engine.
- Necesitas que los conductores administren los viajes asignados on demand y naveguen en una sola app sin cambiar de app.
- Estás creando una app para conductores para las tareas programadas de Fleet Engine en iOS.
No uses el SDK de Driver para iOS en los siguientes casos:
- Solo necesitas la navegación paso a paso en tu app para iOS, sin el seguimiento de Fleet Engine. En su lugar, usa el SDK de Navigation para iOS.
- Debes mostrar el progreso del viaje o de la entrega al pasajero o cliente en una aplicación para consumidores. En su lugar, usa el SDK de consumidor para iOS.
- Debes enviar actualizaciones de datos del vehículo que no sean la ubicación y la ruta. Estas se envían a través de tu backend a Fleet Engine. En su lugar, usa el servicio de Fleet Engine.
- Tu app para conductores se ejecuta en Android. En su lugar, usa el SDK de Driver para Android.
SDK de Driver para iOS: Configuración
- Autenticación: clave de API, token web JSON (JWT)
- También habilita el SDK de Maps para iOS.
- Comienza: Configura el SDK de Driver para iOS
- Referencia: Referencia del SDK de Driver para iOS
- Políticas: Políticas del SDK de Driver para iOS
- Notas de la versión: Notas de la versión del SDK de Driver para iOS
Paquetes oficiales del SDK de Driver para iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
SDK de Driver para iOS: Productos relacionados
- Se suele usar con: SDK de Navigation para iOS, servicio de Fleet Engine, SDK de consumidor para iOS
SDK de Driver para iOS: Errores comunes
- Problema: La primera actualización del vehículo después del inicio puede fallar con el mensaje "update_mask cannot be empty" cuando el parámetro
updateMaskestá vacío. Solución: Proporciona siempre al menos un nombre de campo enupdateMasky controla este error enGMTDVehicleReporterListenerdidFailVehicleUpdate. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Problema:
GMSRoadSnappedLocationProviderno sigue enviando ubicaciones actualizadas cuando el dispositivo no se mueve desde la última actualización, por ejemplo, cuando un conductor espera inactivo. Solución: Para enviar una nueva ubicación actualizada mientras el dispositivo está fijo, detén y, luego, iniciaGMSRoadSnappedLocationProvider(conGMTDVehicleReporterya agregado como su objeto de escucha). Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - Problema: La aplicación para consumidores no renderiza el viaje correctamente si las coordenadas que se pasan a
setDestinations()no coinciden con el punto de referencia del viaje. Solución: Asegúrate de que la latitud y la longitud que se pasan asetDestinations()coincidan con las coordenadas de los puntos de referencia del viaje en Fleet Engine. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - Problema: El uso de un operador de versión optimista (
~>) puede generar compilaciones impredecibles y no repetibles, y omitir una versión carga el SDK más reciente, lo que puede incluir cambios rotundos o aumentar la versión mínima de iOS. Carthage no es compatible. Solución: Fija una versión exacta del SDK de Driver en CocoaPods o Swift Package Manager, y consulta las notas de la versión antes de actualizar. Consulta /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
SDK de Driver para iOS: Funciones heredadas y obsoletas
- Clase
GMTSVehicleMatch: Obsoleta. Reemplazo: No se necesita ningún reemplazo en el SDK de Driver (la asignación de vehículos se controla en Fleet Engine). Síntoma: Se dejó de usar en el SDK de Driver para iOS v2.2.0 y se omitió de la referencia actual del SDK de Driver. Consulta la guía de migración. GMTSServiceTypeyfetchAuthTokenForServiceType:authorizationContext:completion:: Obsoletos desde el 29 de noviembre de 2021. Reemplazo:GMTDAuthorizationfetchTokenWithContext:completion:porGMTDAuthorizationContext(solo se aplica a los reclamos por el ID del vehículo). Consulta la guía de migración.
Qué puedes hacer con el SDK de Driver para iOS
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
- Informa la posición en tiempo real de un vehículo al servicio de Fleet Engine.
- Informa las coordenadas de latitud y longitud de los puntos de referencia del viaje de un vehículo desde el SDK de Navigation al servicio de Fleet Engine.
- Informa al servicio de Fleet Engine la distancia restante de un vehículo hasta su siguiente punto de referencia.
- Informa al servicio de Fleet Engine la hora estimada de llegada de un vehículo a su próximo punto de referencia.
- Informa al servicio de Fleet Engine la ruta que el SDK de Navigation proporcionó para un vehículo.