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 planowanie trasy przez określenie jej celu za pomocą metody ComputeCustomRoutes.
Metoda ComputeCustomRoutes może też pomóc w przestrzeganiu zgodności z trasą, ponieważ pozwala zminimalizować różnicę między trasą wybraną przez operatora a przejechaną trasą.
Używaj zarówno interfejsu Routes Preferred API, jak i pakietu SDK nawigacji, aby w pełni wykorzystać możliwości planowania trasy.
Włączanie metody ComputeCustomRoutes
Zanim użyjesz metody ComputeCustomRoutes w kodze, 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. Maską pola odpowiedzi możesz podać, używając parametru adresu 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 rozpoczyna się od typu wiadomości odpowiedzi najwyższego poziomu, opcjonalnie po niej następuje co najmniej 1 kropka, a następnie nazwa następnego poziomu. Ścieżki pól są zazwyczaj konstruowane w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Maska pola przypadku specjalnego to symbol wieloznaczny „*”, który wybiera wszystkie pola na poziomie głównym.
Aby dowiedzieć się więcej, zobacz:
Przykłady użycia metody ComputeCustomRoutes znajdziesz w artykule o wyliczaniu niestandardowych tras w wersji beta (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.