Nel determinare il percorso migliore per un viaggio di ridesharing, quello più veloce potrebbe non essere sempre l'opzione migliore. Puoi decidere di pianificare il percorso.
L'API Routes Preferred ti consente di pianificare una route specificando un obiettivo di route 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 di navigazione per sfruttare tutti i vantaggi della pianificazione dei percorsi.
Abilita il metodo ComputeCustomRoutes
Prima di poter utilizzare il metodo ComputeCustomRoutes nel codice, devi abilitarlo. Per ulteriori informazioni sull'abilitazione dei metodi API preferiti di Routes, consulta la guida introduttiva.
Utilizzare il metodo ComputeCustomRoutes
Il metodo ComputeCustomRoutes richiede la specifica di 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 di campo è un elenco separato da virgole di percorsi di campo. Ogni percorso di campo è un elenco separato da punti di nomi di campi che rappresentano la gerarchia dei messaggi. Il nome di un campo è la chiave dell'oggetto JSON o il nome del tag di 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 generale, i percorsi dei campi vengono creati 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 in corso...
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.