Regola le preferenze di routing

I calcoli dei percorsi (incluso il cambio di percorso) restituiscono il percorso che richiede meno tempo come percorso migliore predefinito. Tuttavia, puoi modificare la strategia di routing in modo che venga restituito il percorso più breve tra le alternative.

Il termine più breve indica il percorso più breve tra i percorsi ottimali in base al nostro modello di costo predefinito. Il percorso più breve potrebbe non essere il percorso assoluto più breve, poiché questa opzione potrebbe non essere una buona alternativa. Ad esempio, se il percorso più breve assoluto è di 10 km e richiede 50 minuti di guida e un altro percorso è di 15 km, ma richiede solo 20 minuti di guida, la seconda scelta è ottimale, perché spendere 30 minuti per risparmiare 5 km non è un buon compromesso.

Una volta impostata la strategia di routing per un viaggio, questa non cambierà fino al completamento del viaggio. Per modificare la strategia di calcolo del percorso per un viaggio esistente, devi cancellare le destinazioni e reimpostarle con la nuova strategia di calcolo del percorso.

Nota: la funzionalità sopra indicata è destinata ai fornitori di servizi di ridesharing che operano in mercati regolamentati (come l'Europa), che spesso sono tenuti per legge a stabilire i prezzi dei propri servizi in base agli stessi principi dei taxi tradizionali, che addebitano il costo in base principalmente alla distanza percorsa.

Visualizzare i dettagli della route

Per determinare quale strategia di percorso è la scelta ottimale per un determinato waypoint, chiama getRouteInfoForDestination() per ottenere i dettagli del percorso sia per il percorso migliore predefinito sia per il percorso più breve assoluto. I dettagli includono la durata e la distanza da un waypoint di destinazione.

Questi dettagli provengono da GMSNavigationRouteInfo nel callback.

Esempio

L'esempio di codice seguente mostra come ottenere i dettagli del percorso per ciascuna delle due strategie di routing.

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){...}];

Impostazione della strategia di routing

Puoi configurare la strategia di instradamento utilizzando GMSNavigationRoutingOptions e impostando routingStrategy quando chiami setDestinations().

routingStrategy accetta uno dei seguenti valori di enumerazione:

Valore di enumerazione	Descrizione
GMSNavigationRoutingStrategyDefaultBest	Classifica i percorsi in base al modello di costo predefinito dell'SDK Navigation. Questa è la strategia di routing predefinita.
GMSNavigationRoutingStrategyShorter	Classifica i percorsi in base alla distanza. Il percorso con il ranking più alto è il più breve tra quelli restituiti.

Avviso: questa funzionalità non è compatibile con la funzionalità di occultamento del percorso alternativo. L'utilizzo contemporaneamente di queste due funzionalità produrrà risultati imprevisti.

Esempio

Il seguente esempio di codice mostra come impostare la strategia di routing per il percorso più breve.

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){...}];

Percorsi che includono traghetti

Per impostazione predefinita, l'SDK Navigation per iOS esclude i percorsi che includono traghetti. Se preferisci includere opzioni per i traghetti nei tuoi percorsi, puoi modificare questa preferenza di routing in modo da mostrare i segmenti del viaggio con traghetti impostando avoidsFerries su false.

Esempio

Swift

self.mapView.navigator?.avoidsFerries = false

Objective-C

self.mapView.navigator.avoidsFerries = NO

Il formato della callout del percorso

Nella strategia di routing del percorso più breve, i callout lungo il percorso mostrano dettagli sulla distanza. In alternativa, puoi utilizzare i callout ETA.

Configurare il formato del callout della rotta

Puoi modificare il formato della callout del percorso impostando routeCalloutFormat in GMSMapView. routeCalloutFormat accetta uno dei seguenti valori di enumerazione:

Valore di enumerazione	Descrizione
GMSNavigationRouteCalloutFormatDefault	Mostra il tempo rimanente quando si utilizza la strategia di routing per il percorso migliore predefinita. Mostra la distanza rimanente quando si utilizza la strategia di routing del percorso più breve
GMSNavigationRouteCalloutFormatTime	Mostra il tempo rimanente.
GMSNavigationRouteCalloutFormatDistance	Mostra la distanza rimanente.

Esempio

Il seguente esempio di codice mostra come configurare il formato del callout della route.

Swift

self.mapView.routeCalloutFormat = .time

Objective-C

_mapView.routeCalloutFormat = GMSNavigationRouteCalloutFormatTime;