Percorso verso i punti di navigazione

L'SDK Navigation per iOS offre modi avanzati per specificare i waypoint o i punti di navigazione, fornendo un routing più accurato e un'esperienza di arrivo migliore, soprattutto per le destinazioni con più ingressi o punti di navigazione specifici. Puoi raggiungere posizioni esatte utilizzando un navigationPointToken, ovvero una stringa che codifica una località e un contesto di percorso aggiuntivo. Puoi anche combinare le coordinate di latitudine e longitudine con un ID luogo per aggiungere contesto.

Sfondo

Prima della versione 10.10, potevi definire un Waypoint utilizzando le coordinate della località o un ID luogo. Sebbene a volte sia efficace, l'itinerario basato esclusivamente su latitudine e longitudine può talvolta portare a punti di partenza o di arrivo non ottimali, in particolare per luoghi di grandi dimensioni, parchi o edifici con più ingressi. Il risultato potrebbe agganciarsi al segmento stradale più vicino, che potrebbe non essere il punto di accesso più comodo o corretto.

Le opzioni avanzate per i waypoint risolvono questo problema consentendoti di fornire più contesto.

Utilizza un token del punto di navigazione

Per un routing più preciso verso punti di accesso specifici come ingressi, banchine di carico o aree di ritiro designate, puoi utilizzare un navigationPointToken.

Questo token viene ottenuto chiamando il metodo Destinations dell'API Geocoding. Rappresenta un punto di navigazione specifico e instradabile associato a un luogo.

Per specificare un token del punto di navigazione:

1. Ottieni un navigationPointToken dal metodo SearchDestinations dell'API Geocoding.

2. Specifica navigationPointToken quando crei un GMSNavigationWaypoint.

// Create a waypoint using a navigation endpoint token
let waypointTwo = GMSNavigationWaypoint(
  navigationPointToken: "ChIJALijSXPhQkARHmIozCCbXsASEgkFVjYHGH6PgBFrbM7wl3..",
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypointTwo]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

GMSNavigationWaypoint *waypointTwo =
    [[GMSNavigationWaypoint alloc] initWithNavigationPointToken:@"sampleNavigationPointToken"
                                                          title:@"Sydney Opera House"];

Utilizza i token dei punti di navigazione e i token dei percorsi

Puoi recuperare un token del punto di navigazione tramite l'API Geocoding, utilizzarlo in una richiesta dell'API Routes per ottenere un token del percorso e poi passare solo il token del percorso all'SDK Navigation. Il token di percorso mantiene la precisione del token del punto di navigazione. Questo è utile in scenari come il ride sharing o la consegna, in cui utilizzi l'API Routes per calcolare il prezzo di una corsa e vuoi la precisione di un token del punto di navigazione.

Con il token di percorso, l'SDK Navigation avvia la navigazione sullo stesso percorso utilizzato per calcolare il prezzo. In questo modo si riduce il rischio che per il percorso vengano utilizzati percorsi più lunghi o più brevi, il che può creare "shock dei prezzi".

Per ulteriori informazioni sui token dei punti di navigazione e sui token di percorso nell'API Routes, consulta Specifica le località per un percorso e Ottieni un token di percorso. Per scoprire come pianificare un percorso utilizzando un token di percorso, consulta Pianifica un percorso.

Il seguente diagramma mostra come un'app di car pooling o di consegna utilizza i token dei punti di navigazione e i token dei percorsi insieme. A partire dalla versione 11.3, l'app per i conducenti passa solo il token del percorso all'SDK Navigation nel passaggio 7.

Combina l'ID luogo e la località

A partire dalla versione 10.10, puoi fornire sia un ID luogo sia le coordinate della località quando crei un waypoint. Questo metodo è utile quando vuoi specificare un punto preciso (la posizione) fornendo al contempo il contesto del luogo complessivo (l'ID luogo). In questo modo, l'SDK di navigazione può offrire un'esperienza di arrivo più completa evidenziando l'edificio di destinazione o mostrando i punti di interesse nelle vicinanze correlati all'ID luogo.

// Create a waypoint using both the latlng and placeID
let waypoint = GMSNavigationWaypoint(
  location: CLLocationCoordinate2DMake(-33.85657945261524, 151.21535034203333),  
  placeID: "ChIJ3S-JXmauEmsRUcIaWtf4MzE",
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypoint]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint = [[GMSNavigationWaypoint alloc] initWithLocation:placeID:coordinate title:@"waypoint from location and placeiD"];

Considerazioni

Quando fornisci sia placeID che location:

• La route ha come target principale l'intervallo location specificato.
• placeID fornisce un contesto che migliora l'esperienza di arrivo.
• Fallback: se l'SDK determina che il placeID fornito corrisponde a una caratteristica troppo lontana dal location specificato, ignora il placeID. In questo scenario, il percorso procede solo fino a location e i miglioramenti dell'esperienza di arrivo specifici per il luogo non sono disponibili.

Riepilogo delle configurazioni dei waypoint valide