Pianificare un percorso

A volte potresti voler pianificare il percorso fornito dall'app agli utenti. L'utilizzo di un il token di route dell'API Routes (o dell'API Routes Preferred) può aiutarti a specificare due cose per il percorso pianificato:

• Una polilinea per il percorso.

• Obiettivi del percorso

Ad esempio, ecco alcuni esempi di obiettivi di routing che potresti avere:

• Riduci al minimo i tempi di consegna: un'attività che effettua la consegna di cibo potrebbe voler ridurre al minimo il tempo necessario per la consegna. il tempo necessario per consegnare il cibo.

• Riduci al minimo i tempi di percorrenza o il consumo di carburante: un'attività di logistica potrebbe volere migliorare l'efficienza dei conducenti e ridurre i costi del carburante.

• Riduci al minimo il tempo di arrivo: un'operazione di spedizione del servizio potrebbe decidere di Riduci al minimo il tempo necessario per portare gli operatori a una richiesta di job.

• Riduci i costi e migliora la sicurezza: un'attività di ride sharing potrebbe voler trovare un percorso che costa meno per i passeggeri ed evita determinate aree per la sicurezza motivi.

di Gemini Advanced.

Importante: il percorso effettivo può variare rispetto al percorso pianificato fornito da il token. Modifica del traffico, delle condizioni delle strade o del veicolo che non si discosta un determinato percorso può comportare modifiche al percorso. Man mano che si verificano cambiamenti, L'SDK di navigazione tenta continuamente di tornare percorso pianificato o se il ritorno non è pratico, segue gli obiettivi del percorso il token del percorso.

Per ulteriori informazioni sulla pianificazione di un percorso utilizzando un token di route, consulta Richiedi un token di route.

Perché utilizzare un token di route per gli obiettivi delle route

Con un token di route dell'API Routes o Routes Preferred, disponi di più controllo sul percorso fornito:

• Pianifica un percorso in anticipo per l'utilizzo dell'SDK di navigazione quando possibile.

• Scegli il percorso migliore da utilizzare per l'SDK di navigazione. Se richiedi token di route durante la generazione di route nell'API Routes, ottieni un token di route per ogni route generata. Dopodiché puoi scegliere il token per il percorso che vuoi utilizzare quando lo passi SDK di navigazione.

• Fai una stima del prezzo in anticipo, comprese le stime di orario di arrivo stimato e la distanza. Sebbene il costo e il tempo effettivi possano variare, questa stima riduce il divario tra il costo del percorso previsto ed effettivo.

• Specificare obiettivi più avanzati per il percorso, ad esempio il percorso ecologico o il percorso più breve. percorso.

di Gemini Advanced.

Suggerimento: un token di route è per un'origine e una destinazione specifiche e a un in un determinato momento. Devi effettuare una nuova richiesta API Routes per un nuovo token di route.

Come funzionano i token di route dell'API Routes

Puoi utilizzare l'API Routes o l'API Routes Preferred per pianificare un percorso utilizzando gli obiettivi del percorso. L'API Routes restituisce un token di routing che puoi passare all'SDK di navigazione per guidarti percorsi il tuo veicolo.

Ecco cosa succede quando richiedi e utilizzi un token di route API Routes:

1. L'API Routes restituisce un token di route criptato che include la route gli obiettivi delle polilinee e dei percorsi.

2. Passi il token di route all'SDK di navigazione.

3. L'SDK di navigazione recupera il percorso oppure, se non è disponibile a causa del mutare delle condizioni, recupera la corrispondenza migliore percorso.

4. Durante la guida, se il traffico o altre condizioni della strada cambiano o se un veicolo devia dal percorso pianificato, i percorsi modificati continuamente tentare di trovare la migliore route in base agli obiettivi di route nel token.

Questo processo massimizza la vicinanza del percorso effettivo al percorso pianificato.

Perché un percorso pianificato potrebbe non essere seguito esattamente

Pensa al percorso pianificato e agli obiettivi del percorso come linee guida da seguire: non sono prescrittivi. Potresti notare una differenza tra il percorso pianificato e il percorso fornito dalla navigazione guidata a causa di differenze di strada condizioni, la posizione di partenza o altri parametri che sono stati modificati da quando ha creato il percorso pianificato. Questa differenza potrebbe determinare una mancata corrispondenza i tuoi obiettivi pianificati ed effettivi per distanza e orario di arrivo stimato, tra gli altri percorsi importanti qualità del prodotto.

Suggerimento: come best practice, richiedi sempre un nuovo token di route ogni ora imposti la destinazione nell'SDK di navigazione e prevede delle varianti per evitare ripercussioni sulla tua attività.

Pianificare un percorso utilizzando un token di route

Puoi pianificare un percorso creando un token di percorso e passandolo a l'SDK di navigazione, come descritto nei passaggi che seguono.

Passaggio 1: crea un token di route utilizzando l'API Routes o Routes Preferred

1. Richiedi un token di route con uno dei seguenti metodi:

   • API Routes: computeRoutes. Per ulteriori informazioni richiedere un token di route nell'API Routes, consulta Calcola una route e Richiedi un token di route.

   • API preferita di Routes: computeCustomRoutes. Per ulteriori informazioni richiedere un token di route nell'API Routes Preferred, consulta Pianifica un percorso.

2. Configura la richiesta di percorso per soddisfare i requisiti per l'utilizzo di un percorso. token:

   • Imposta travel_mode su DRIVING
   • Imposta routing_preference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL
   • NON utilizzare Via waypoint

Passaggio 2: passa il token di route all'SDK di navigazione

1. Memorizza il token di route: imposta una stringa nell'SDK di navigazione. per archiviare il token di route. Ad esempio:

   String routeToken = "route token returned by Routes API";

   Esempio di token di route restituito:

   {
   // Other fields
   "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
   }
   

2. Trasmetti il token di route all'SDK di navigazione utilizzando il token Navigator.setDestinations, specificando la stessa destinazione Tappe che hai utilizzato durante la creazione del token di route:

   setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

   Ad esempio:

   CustomRoutesOptions customRoutesOptions =
         CustomRoutesOptions.builder()
         .setRouteToken(routeToken)
         .build();

di Gemini Advanced.

Nota: se devi ripetere lo stesso percorso, richiedi un nuovo token di percorso.

Il metodo Navigator.setDestinations restituisce lo stato della richiesta. Se trova un percorso dalla posizione del veicolo alla destinazione specificata, restituisce RouteStatus.OK.

Per ulteriori informazioni su questo metodo, consulta Navigator.setDestinations

Esempio

Il seguente esempio di codice mostra come specificare un percorso pianificato utilizzando un di routing.

    ArrayList <Waypoint> destinations = Lists.newArrayList();
    Waypoint waypoint1 =
       Waypoint.builder()
          .setLatLng(10, 20)
          .setTitle("title")
          .setVehicleStopover(true)
          .build();
    destinations.add(waypoint1);
    Waypoint waypoint2 =
       Waypoint.builder()
          .setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
          .setTitle("title")
          .setVehicleStopover(true)
           .build()
    destinations.add(waypoint2);

    String routeToken = "route token returned by Routes API";

    CustomRoutesOptions customRoutesOptions =
       CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(CustomRoutesOptions.TravelMode.TWO_WHEELER)
          .build();

    // Existing flow to get a Navigator.
    NavigationApi.getNavigator(...);

    // Existing flow for requesting routes.
    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions);

    // Or with display options.
    DisplayOptions displayOptions = new DisplayOptions();

    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions, displayOptions);

Come interagiscono i token di route e l'SDK di navigazione

Ecco come il percorso generato dall'SDK di navigazione e dalla pianificazione route nel token di route interagiscono tra loro:

• Sostituisce tutte le destinazioni impostate in precedenza.

• Utilizza il luogo di partenza del veicolo.

• Si adatta alle condizioni del traffico e della strada. Consulta: Perché un percorso pianificato potrebbe non essere seguito esattamente.

• Ignora se non necessarie le seguenti opzioni relative al routing:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• Segue:

  • Opzioni correlate ai waypoint, ad esempio la preferenza relativa al lato della strada.

  • Obiettivi del percorso. Se l'SDK di navigazione deve regolare il percorso restituito, utilizza gli obiettivi del percorso specificati richiedendo il token di route. Per questo motivo, devi utilizzare lo stesso le opzioni relative ai waypoint specificate nell'API Routes.