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ò anche contribuire alla conformità del percorso consentendoti di ridurre al minimo la differenza tra il percorso selezionato dall'operatore e quello seguito.
Utilizza sia l'API Routes Preferred sia l'SDK Navigation per sfruttare tutti i vantaggi della pianificazione dei percorsi.
Abilita 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 di 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 ed è facoltativamente seguito da uno o più punti e dal livello successivo del nome del campo. In genere, i percorsi dei campi vengono costruiti nel seguente modo:
topLevelField[.secondLevelField][.thirdLevelField][...]
Una maschera per i campi dei casi speciali è un carattere jolly "*", che seleziona tutti i campi a livello di directory principale.
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 dei pedaggi, consulta Calcolare le tariffe dei pedaggi.
Per esempi di calcolo delle tariffe dei pedaggi, consulta la sezione Esempi di calcolo di percorsi personalizzati.