Quando determini il percorso migliore per un viaggio in ridesharing, il percorso più veloce potrebbe non essere sempre l'opzione migliore. Potresti voler pianificare il tuo percorso.
L'API Routes Preferred ti consente di pianificare un itinerario specificando
un obiettivo dell'itinerario utilizzando il metodo ComputeCustomRoutes.
Il metodo ComputeCustomRoutes può anche contribuire alla conformità del percorso consentendo di ridurre al minimo la differenza tra il percorso selezionato dall'operatore e quello percorso.
Utilizza sia l'API Routes Preferred sia l'SDK Navigation per sfruttare appieno i vantaggi della pianificazione del percorso.
Abilita il metodo ComputeCustomRoutes
Prima di poter utilizzare il metodo ComputeCustomRoutes nel tuo codice, devi
attivarlo. Per ulteriori informazioni sull'abilitazione dei metodi dell'API Routes Preferred, consulta la Guida introduttiva.
Utilizzare il metodo ComputeCustomRoutes
Il metodo ComputeCustomRoutes richiede di specificare una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando
il parametro URL $fields o fields oppure l'intestazione HTTP/gRPC
X-Goog-FieldMask. Per ulteriori informazioni, vedi
Parametri di sistema.
Il valore della maschera del campo è un elenco separato da virgole di percorsi dei campi. Ogni percorso del campo è un elenco di nomi di campi separati da punti che rappresentano la gerarchia del messaggio. Un nome di campo è la chiave dell'oggetto JSON o il nome del tag del campo protobuf. Il percorso del campo inizia dal tipo di messaggio di risposta di primo livello ed è facoltativamente seguito da uno o più punti e poi dal livello successivo del nome del campo. In generale, i percorsi dei campi vengono creati nel seguente modo:
topLevelField[.secondLevelField][.thirdLevelField][...]
Una maschera di campo speciale è un carattere jolly "*", che seleziona tutti i campi di primo livello.
Per ulteriori informazioni, vedi:
Per esempi di utilizzo del metodo ComputeCustomRoutes, consulta
Esempi di calcolo di una route personalizzata (beta).
Calcolo dei pedaggi
Per informazioni sul calcolo dei pedaggi, consulta Calcolare i pedaggi.
Per esempi di calcolo dei pedaggi, consulta la sezione Esempi di calcolo di una route personalizzata.