Podczas określania najlepszej trasy dla przejazdu z udostępniania przejazdu najszybsza trasa nie zawsze jest najlepszą opcją. Możesz zaplanować trasę.
Interfejs Routes Preferred API umożliwia zaplanowanie trasy przez określenie celu trasy za pomocą metody ComputeCustomRoutes.
Metoda ComputeCustomRoutes może też pomóc w przestrzeganiu trasy, ponieważ pozwala zminimalizować różnicę między trasą wybraną przez operatora a przejechaną trasą.
Aby w pełni korzystać z planowania tras, używaj zarówno interfejsu Routes Preferred API, jak i pakietu SDK Nawigacji.
Włączanie metody ComputeCustomRoutes
Zanim użyjesz metody ComputeCustomRoutes w kodzie, musisz ją włączyć. Więcej informacji o włączaniu metod interfejsu Routes Preferred API znajdziesz w artykule Pierwsze kroki.
Używanie metody ComputeCustomRoutes
Metoda ComputeCustomRoutes wymaga podania w danych maski pola odpowiedzi. Możesz podać maskę pola odpowiedzi, używając parametru URL $fields lub fields albo nagłówka HTTP/gRPC X-Goog-FieldMask. Więcej informacji znajdziesz w artykule Parametry systemu.
Wartość maski pola to lista ścieżek pól rozdzielonych przecinkami. Każda ścieżka pola jest listą nazw pól rozdzielonych kropkami, która reprezentuje hierarchię wiadomości. Nazwa pola to klucz obiektu JSON lub nazwa tagu pola protobuf. Ścieżka pola zaczyna się od typu wiadomości odpowiedzi na najwyższym poziomie, a opcjonalnie po niej następuje co najmniej 1 kropka, a potem nazwa pola na następnym poziomie. Ścieżki pól są zazwyczaj konstruowane w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
W szczególnym przypadku maską pola jest symbol wieloznaczny „*”, który wybiera wszystkie pola na poziomie katalogu głównego.
Aby dowiedzieć się więcej, zobacz:
Przykłady korzystania z metody ComputeCustomRoutes znajdziesz w artykule Przykłady obliczania trasy niestandardowej (beta).
Obliczanie opłat za przejazd autostradą
Informacje o obliczaniu opłat za przejazd znajdziesz w artykule Obliczanie opłat za przejazd.
Przykłady obliczania opłat za przejazd znajdziesz w artykule Przykłady obliczania trasy niestandardowej.