Gdy określasz najlepszą trasę przejazdu współdzielonego, najszybsza trasa nie zawsze jest najlepszą opcją. Możesz zaplanować trasę.
Interfejs Routes Preferred API umożliwia planowanie trasy przez określenie celu trasy za pomocą metody ComputeCustomRoutes.
Metoda ComputeCustomRoutes może też pomóc w zachowaniu zgodności z trasą, ponieważ pozwala zminimalizować różnicę między trasą wybraną przez operatora a trasą przejechaną.
Aby w pełni wykorzystać możliwości planowania tras, używaj zarówno interfejsu Routes Preferred API, jak i pakietu Navigation SDK.
Włącz metodę 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 określenia maski pola odpowiedzi w danych wejściowych. 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 rozdzielona przecinkami lista ścieżek pól. Każda ścieżka pola to rozdzielona kropkami lista nazw pól, które reprezentują hierarchię wiadomości. Nazwa pola to klucz obiektu JSON lub nazwa tagu pola protobuf. Ścieżka pola zaczyna się od typu wiadomości odpowiedzi najwyższego poziomu, po którym opcjonalnie następuje co najmniej 1 kropka, a następnie nazwa pola kolejnego poziomu. Ogólnie ścieżki pól są tworzone w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Specjalna maska pola 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 Przykłady obliczania trasy niestandardowej.
Obliczanie opłat drogowych
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.