Un feed de datos paso a paso proporciona información de solo navegación a los dispositivos que no están diseñados para guías de navegación basadas en mapas. Proporciona las próximas maniobras con los elementos que debes ingresar:
- íconos (izquierda, derecha, cambio de sentido)
- girar los números en las rotondas
- nombres de rutas
- las distancias estimadas y el tiempo hasta el siguiente paso de la navegación o el destino final
Puedes usar el feed paso a paso para crear experiencias en las que no sea adecuada la IU completa del SDK de Navigation, como en pantallas pequeñas. Por ejemplo, podrías usar esta opción para pasajeros de vehículos de dos ruedas, donde puedes proyectar orientación solo de navegación para ayudarlos a llegar a su destino más rápido, con más confianza y con una cantidad mínima de distracciones.
Elementos esenciales de la pantalla de navegación
Los campos principales para 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 para el paso actual o el destino, los cuales están disponibles en GMSNavigationNavInfo. La imagen de la derecha muestra un ejemplo de estos elementos esenciales de navegación.
Configura 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 de los pasos para brindar navegación paso a paso a los usuarios.
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.
Cómo controlar el evento didChangeNavInfo
Crea un objeto de escucha para el evento didChangeNavInfo
para agregar compatibilidad paso a paso a tu app. En el objeto de escucha de eventos, usa las siguientes clases y enumeraciones 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 la 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 encaminar, redirecciona o detenida.
GMSNavigationDrivingSide: Es una enumeración que define si este paso es en una ruta de conducción a la derecha o de conducción a la izquierda.
GMSNavigationManeuver: Es una enumeración que define la acción de navegación que se 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:
Enruta: El estado
GMSNavigationNavStateEnroute
significa que la navegación guiada está activa en el momento y que el usuario se encuentra en la ruta proporcionada. Hay información disponible sobre el próximo paso de maniobra actual.Redireccionamiento:
GMSNavigationNavStateRerouting
significa que la navegación está en curso, pero el navegador está buscando una ruta nueva. El próximo paso de la maniobra no está disponible porque aún no hay una ruta nueva.Detenida:
GMSNavigationNavStateStopped
significa que finalizó la navegación. Por ejemplo, la navegación se detiene cuando el usuario sale de la navegación en la app. En la app de ejemplo, el estadoGMSNavigationNavStateStopped
borra la pantalla de información de navegación para evitar que se muestren las instrucciones de pasos persistentes.
Cómo crear íconos para las maniobras
El enum GMSNavigationManeuver define cada maniobra posible que se podría producir mientras navegas, y puedes obtener la maniobra para un paso determinado desde la propiedad maneuver
de GMSNavigationStepInfo.
Debes crear íconos de maniobras y vincularlos con sus maniobras asociadas.
En algunos casos, puedes configurar una asignación uno a uno para un ícono, como GMSNavigationManeuverDestinationLeft
y GMSNavigationManeuverDestinationRight
.
Sin embargo, dado que algunas maniobras comparten características con otros malvados, es posible que quieras asignar más de una maniobra a un solo ícono. Por ejemplo, tanto GMSNavigationManeuverTurnLeft
como GMSNavigationManeuverOnRampLeft
podrían asignarse al ícono de giro a la izquierda.
Algunas maniobras contienen una etiqueta adicional "En sentido de las manecillas del reloj" o "En sentido contrario a las manecillas del reloj", que el SDK determina en función del lado de conducción de un país. Por ejemplo, en países donde la conducción se realiza por el lado izquierdo de la ruta, los conductores dan una rotonda o gira en U en el sentido de las manecillas del reloj, mientras que los países que circulan por el lado derecho de la carretera giran en sentido contrario a las manecillas del reloj. El SDK de Navigation detecta si una maniobra se produce en el tráfico hacia la izquierda o la derecha, y genera la maniobra adecuada. Por lo tanto, tu ícono de maniobra puede ser diferente para maniobra en el sentido de las manecillas del reloj o en sentido antihorario.
Expandir para ver ejemplos de íconos de diferentes maniobras
Ícono de ejemplo | 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
|