Ajustar las preferencias de enrutamiento

Los cálculos de rutas (incluido el cambio de ruta) muestran la ruta que lleva la menor cantidad de tiempo para navegar como la mejor ruta predeterminada. Sin embargo, puedes cambiar la estrategia de enrutamiento para que se muestre la más corta de las rutas alternativas.

El término más corta significa la ruta más corta entre las rutas óptimas según nuestro modelo de costos predeterminado. La ruta más corta podría no ser la absoluta más corta, ya que esa opción podría ser una alternativa deficiente. Por ejemplo, si la ruta más corta absoluta es de 10 km y lleva 50 minutos recorrerla, y otra ruta es de 15 km, pero solo lleva 20 minutos recorrerla, la segunda opción es óptima, ya que no vale la pena invertir 30 minutos para reducir cinco kilómetros.

Una vez que establezcas la estrategia de rutas para un viaje, no cambiará hasta que se complete. Para cambiar la estrategia de ruta de un viaje existente, debes borrar los destinos y restablecerlos con la nueva estrategia de ruta.

Nota: La función mencionada anteriormente está destinada a los proveedores de viajes compartidos que operan en mercados regulados (como Europa), a quienes la ley suele exigirles que fijen los precios de sus servicios según los mismos principios que los taxis tradicionales, que cobran principalmente en función de la distancia recorrida.

Cómo obtener detalles de la ruta

Para determinar qué estrategia de ruta es la opción óptima para un punto de referencia determinado, llama a getRouteInfoForDestination() para obtener detalles de la mejor ruta predeterminada y de la ruta más corta absoluta. Los detalles incluyen la duración y la distancia a un punto de referencia de destino.

Estos detalles provienen de GMSNavigationRouteInfo en la devolución de llamada.

Ejemplo

En el siguiente ejemplo de código, se muestra cómo obtener los detalles de la ruta para cada una de las dos estrategias de rutas.

Swift

let routingOptions = GMSNavigationRoutingOptions()
navigator?.getRouteInfoForDestination(destination,
                                      routingOptions: routingOptions) { routeInfo in
  ...
}

Objective-C

GMSNavigationRoutingOptions *routingOptions =
    [[GMSNavigationRoutingOptions alloc] init];
[navigator getRouteInfoForDestination:destination
                   withRoutingOptions:routingOptions
                             callback:^(GMSNavigationRouteInfo *routeInfo){...}];

Cómo establecer la estrategia de enrutamiento

Puedes configurar la estrategia de enrutamiento con GMSNavigationRoutingOptions y establecer routingStrategy cuando llames a setDestinations().

routingStrategy toma uno de los siguientes valores de enumeración:

Valor de enumeración	Descripción
GMSNavigationRoutingStrategyDefaultBest	Clasifica las rutas según el modelo de costos predeterminado del SDK de Navigation. Esta es la estrategia de enrutamiento predeterminada.
GMSNavigationRoutingStrategyShorter	Clasifica las rutas por distancia. La ruta con la clasificación más alta es la más corta de las que se muestran.

Advertencia: Esta función no es compatible con la función Ocultar ruta alternativa. Si usas estas dos funciones al mismo tiempo, se producirán resultados inesperados.

Ejemplo

En el siguiente ejemplo de código, se muestra cómo establecer la estrategia de rutas más cortas.

Swift

let routingOptions = GMSNavigationRoutingOptions(routingStrategy: .shorter)
navigator?.setDestinations(destinations,
                           routingOptions: routingOptions) { routeStatus in
  ...
}

Objective-C

GMSNavigationRoutingOptions *routingOptions = [[GMSNavigationRoutingOptions alloc] initWithRoutingStrategy:GMSNavigationRoutingStrategyShorter];
[navigator setDestinations:destinations
            routingOptions:routingOptions
                  callback:^(GMSRouteStatus routeStatus){...}];

Rutas que incluyen ferris

De forma predeterminada, el SDK de Navigation para iOS excluye las rutas que incluyen transbordadores. Si prefieres incluir opciones de ferry como parte de tus rutas, puedes ajustar esta preferencia de rutas para exponer el viaje a los tramos de ferry configurando avoidsFerries en false.

Ejemplo

Swift

self.mapView.navigator?.avoidsFerries = false

Objective-C

self.mapView.navigator.avoidsFerries = NO

Formato del texto destacado de la ruta

Con la estrategia de rutas más cortas, las leyendas a lo largo de la ruta muestran detalles de la distancia. Sin embargo, puedes usar los textos destacados de ETA.

Cómo configurar el formato del texto destacado de la ruta

Puedes cambiar el formato de la leyenda de ruta estableciendo routeCalloutFormat en GMSMapView. routeCalloutFormat toma uno de los siguientes valores de enumeración:

Valor de enumeración	Descripción
GMSNavigationRouteCalloutFormatDefault	Muestra el tiempo restante cuando se usa la estrategia de rutas de la mejor ruta predeterminada. Muestra la distancia restante cuando se usa la estrategia de enrutamiento de ruta más corta.
GMSNavigationRouteCalloutFormatTime	Muestra el tiempo restante.
GMSNavigationRouteCalloutFormatDistance	La letra D muestra la distancia restante.

Ejemplo

En el siguiente ejemplo de código, se muestra cómo configurar el formato de la llamada de ruta.

Swift

self.mapView.routeCalloutFormat = .time

Objective-C

_mapView.routeCalloutFormat = GMSNavigationRouteCalloutFormatTime;