Un feed de datos de instrucciones paso a paso proporciona información de navegación solo a dispositivos que no están diseñados para la guía de navegación basada en mapas. Proporciona las próximas maniobras con los elementos que proporcionas:
- íconos (izquierda, derecha, giro en U)
- números de giro en las rotondas
- nombres de las rutas
- las distancias y el tiempo estimados hasta el próximo paso de navegación o el destino final
Puedes usar el feed paso a paso para crear experiencias en las que la IU completa del SDK de Navigation no sea adecuada, como en pantallas pequeñas. Por ejemplo, puedes usar esta función para los pasajeros de vehículos de dos ruedas, en los que puedes proyectar indicaciones de navegación solo para ayudarlos a llegar a sus destinos más rápido y con más confianza con mínimas distracciones.
Elementos de visualización de navegación esenciales
Los campos principales de cada paso de navegación son el nombre completo de la ruta, la maniobra y la distancia total del paso, que están disponibles en GMSNavigationStepInfo
.
Para el viaje general, te recomendamos que muestres el tiempo y la distancia restantes hasta el paso actual o el destino, que están disponibles en GMSNavigationNavInfo
.
En la imagen de la derecha, se muestra un ejemplo de estos elementos de navegación esenciales.
Cómo configurar un objeto de escucha de eventos
Para usar datos solo de navegación, debes implementar un objeto de escucha de eventos para el evento didChangeNavInfo
. Dentro del objeto de escucha de eventos, accede a la información del viaje y del paso para proporcionarles a los usuarios una navegación paso a paso.
Para implementar controladores de eventos, el controlador de vista del mapa debe implementar el protocolo GMSNavigatorListener
. Para obtener información detallada sobre cómo controlar eventos en el SDK de Navigation para iOS, consulta Cómo detectar eventos de navegación.
Controla el evento didChangeNavInfo
Crea un objeto de escucha para el evento didChangeNavInfo
para agregar compatibilidad con instrucciones paso a paso a tu app. En el objeto de escucha de eventos, usa las siguientes clases y enums para controlar la navegación paso a paso:
GMSNavigationNavInfo
: Es la clase que define información sobre el estado de la navegación.GMSNavigationStepInfo
: Es una clase que define información sobre un solo paso a lo largo de una ruta de navegación.GMSNavigationNavState
: Es una enumeración que define el estado actual de una navegación, como en ruta, en cambio de ruta o detenido.GMSNavigationDrivingSide
: Es un enum que define si este paso se encuentra en una ruta con circulación por la derecha o por la izquierda.GMSNavigationManeuver
: Es una enumeración que define la acción de navegación que se debe realizar, como girar a la izquierda o a la derecha.
A continuación, se muestran ejemplos de objetos de escucha de eventos para el evento didChangeNavInfo
:
Objective-C
// ViewController.h @interface SomeViewController () <GMSNavigatorListener> @end // ViewController.m @implementation SomeViewController // Some initialization code. ... { ... [_mapView.navigator addListener:self]; ... } #pragma mark GMSNavigatorListener - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo { // Get the current step information if (navInfo.navState == GMSNavigationNavStateEnroute) { GMSNavigationStepInfo *currentStep = navInfo.currentStep; if (currentStep) { ... roadNameLabel.text = currentStep.simpleRoadName; ... } } ... }
Swift
// ViewController.swift class SomeViewController: UIViewController { ... mapView.navigator?.add(self); ... } extension SomeViewController: GMSNavigatorListener { func navigator(_ navigator: GMSNavigator, didUpdateNavInfo navInfo: GMSNavigationNavInfo) { // Get the current step information if navInfo.navState == .enroute { if let currentStep = navInfo.currentStep { ... roadNameLabel.text = currentStep.simpleRoadName ... } } } }
Estados de navegación
Usa la propiedad navState
de GMSNavigationNavInfo
para obtener el estado actual de la navegación, que es uno de los siguientes:
En ruta: El estado
GMSNavigationNavStateEnroute
significa que la navegación guiada está activa y que el usuario está en la ruta proporcionada. Hay información disponible sobre el próximo paso de maniobra actual.Recalculando:
GMSNavigationNavStateRerouting
significa que la navegación está en curso, pero el navegador está buscando una ruta nueva. El próximo paso de maniobra no está disponible porque aún no hay una ruta nueva.Detenido:
GMSNavigationNavStateStopped
significa que la navegación finalizó. Por ejemplo, la navegación se detiene cuando el usuario sale de la navegación en la app. En la app de ejemplo, un estadoGMSNavigationNavStateStopped
borra la pantalla de información de navegación para evitar que se muestren instrucciones de pasos restantes.
Indicación de carril
El SDK de Navigation representa los carriles en la tarjeta de giro de navegación como objetos de datos GMSNavigationLane
y GMSNavigationLaneDirection
. Un objeto GMSNavigationLane
representa un carril específico durante la navegación y tiene una lista de objetos GMSNavigationLaneDirection
que describen todos los giros que se pueden realizar desde este carril.
La dirección recomendada que debe tomar un conductor en un carril se marca con el campo recommended
.
Ejemplo de indicación de carril
En el siguiente fragmento, se ilustra la representación de datos de los carriles que se muestran en la captura de pantalla anterior.
// Lane 1
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]
// Lane 2
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]
// Lane 3
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]
// Lane 4
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]
Imágenes de la indicación de carril
El SDK de Navigation admite la generación de imágenes de carriles para cada paso de navegación, como lo indica GMSNavigationStepInfo
. Estos íconos se ajustan a las instrucciones de tamaño de imagen de CarPlay.
Swift
let currentStepInfo = navInfo.currentStep let options = GMSNavigationStepImageOptions() options.maneuverImageSize = .square96 options.screenMetrics = UIScreen.mainScreen let maneuverImage = currentStepinfo.maneuverImage(options: options)
Objective-C
GMSNavigationStepInfo *stepInfo = navInfo.currentStep; GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init]; options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96; options.screenMetrics = UIScreen.mainScreen; UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];
Cómo crear íconos para maniobras
La enumeración GMSNavigationManeuver
define cada maniobra posible que podría ocurrir durante la navegación, y puedes obtener la maniobra de un paso determinado desde la propiedad maneuver
de GMSNavigationStepInfo
.
Debes crear íconos de maniobra y vincularlos con sus maniobras asociadas.
Para algunas maniobras, puedes configurar una asignación uno a uno a un ícono, como GMSNavigationManeuverDestinationLeft
y GMSNavigationManeuverDestinationRight
. Sin embargo, como algunas maniobras comparten características con otras, es posible que desees asignar más de una maniobra a un solo ícono. Por ejemplo, GMSNavigationManeuverTurnLeft
y GMSNavigationManeuverOnRampLeft
podrían asignarse al ícono de giro a la izquierda.
Algunas maniobras contienen una etiqueta adicional de "Horario" o "Contrarreloj", que el SDK determina en función del lado de conducción de un país. Por ejemplo, en los países en los que se conduce por el lado izquierdo de la ruta, los conductores toman una rotonda o un giro en U en el sentido de las manecillas del reloj, mientras que en los países en los que se conduce por el lado derecho de la ruta, se hace en sentido contrario a las manecillas del reloj. El SDK de Navigation detecta si se produce una maniobra en el tráfico de la izquierda o la derecha y muestra la maniobra adecuada. Por lo tanto, el ícono de maniobra puede ser diferente para una maniobra en el sentido de las manecillas del reloj en comparación con una maniobra en sentido contrario.
Expande para ver ejemplos de íconos de diferentes maniobras
Ícono de muestra | Maniobras paso a paso |
---|---|
DEPART UNKNOWN |
|
STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
|
|
TURN_RIGHT ON_RAMP_RIGHT
|
|
TURN_LEFT ON_RAMP_LEFT
|
|
TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
|
|
TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
|
|
TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
|
|
TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
|
|
TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
|
TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
|
|
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
|
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_RIGHT_CLOCKWISE
|
|
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
|
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
|
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
|
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_LEFT_CLOCKWISE
|
|
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
|
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
|
ROUNDABOUT_U_TURN_CLOCKWISE
|
|
ROUNDABOUT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_CLOCKWISE
|
|
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
|
ROUNDABOUT_EXIT_CLOCKWISE
|
|
MERGE_RIGHT OFF_RAMP_RIGHT
|
|
MERGE_LEFT OFF_RAMP_LEFT
|
|
FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
|
|
FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
|
|
MERGE_UNSPECIFIED
|
|
DESTINATION
|
|
DESTINATION_RIGHT
|
|
DESTINATION_LEFT
|
|
FERRY_BOAT
|
|
FERRY_TRAIN
|
Cómo usar íconos generados
El SDK de Navigation admite la generación de íconos de maniobras para un GMSNavigationStepInfo
determinado. Estos íconos se ajustan a la guía de tamaño de imágenes de CarPlay.
Swift
let currentStepInfo = navInfo.currentStep let options = GMSNavigationStepImageOptions() options.maneuverImageSize = .square96 options.screenMetrics = UIScreen.mainScreen let maneuverImage = currentStepinfo.maneuverImage(options: options)
Objective-C
GMSNavigationStepInfo *stepInfo = navInfo.currentStep; GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init]; options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96; options.screenMetrics = UIScreen.mainScreen; UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];