Quando devi determinare il percorso migliore per un viaggio in ridesharing, il percorso più veloce potrebbe non essere sempre l'opzione migliore. Ti consigliamo di pianificare il percorso.
L'API Routes Preferred ti consente di pianificare un itinerario specificando un obiettivo di itinerario utilizzando il metodo ComputeCustomRoutes.
Il metodo ComputeCustomRoutes può essere utile anche per la conformità al percorso, in quanto consente 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 tutti i vantaggi della pianificazione dei percorsi.
Attiva il metodo ComputeCustomRoutes
Prima di poter utilizzare il metodo ComputeCustomRoutes nel codice, devi attivarlo. Per ulteriori informazioni sull'abilitazione dei metodi dell'API Route Preferred, consulta la guida introduttiva.
Utilizzare il metodo ComputeCustomRoutes
Il metodo ComputeCustomRoutes richiede di specificare una maschera di campo della 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, consulta
Parametri di sistema.
Il valore della maschera di campo è un elenco separato da virgole di percorsi dei campi. Ogni percorso del campo è un elenco separato da punti di nomi di campi che rappresentano la gerarchia dei messaggi. 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 e, facoltativamente, è seguito da uno o più punti e poi dal livello successivo del nome del campo. In genere, i percorsi dei campi vengono costruiti nel seguente modo:
topLevelField[.secondLevelField][.thirdLevelField][...]
Una maschera di campo per casi speciali è un carattere jolly “*”, che seleziona tutti i campi di livello radice.
Per ulteriori informazioni, vedi:
Per esempi di utilizzo del metodo ComputeCustomRoutes, consulta
Esempi di calcolo di una route personalizzata (beta).
Calcolo delle tariffe per i pedaggi
Per informazioni sul calcolo delle tariffe per il pedaggio, consulta Calcolare le tariffe per il pedaggio.
Per esempi di calcolo dei pedaggi, consulta Esempi di calcolo di un itinerario personalizzato.