Przy wyznaczaniu najlepszej trasy przejazdu w ramach wspólnych przejazdów najszybsza trasa nie zawsze jest najlepszym wyborem. 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 zapewnieniu zgodności z trasą, ponieważ pozwala zminimalizować różnicę między trasą wybraną przez operatora a trasą przejechaną.
Aby w pełni wykorzystać zalety planowania trasy, używaj zarówno interfejsu Routes Preferred API, jak i pakietu Navigation SDK.
Włącz metodę ComputeCustomRoutes
Zanim użyjesz w kodzie metody ComputeCustomRoutes, 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 wejściowych maski pola odpowiedzi. Maskę pola odpowiedzi możesz podać za pomocą parametru adresu URL $fields lub fields albo za pomocą nagłówka HTTP/gRPC X-Goog-FieldMask. Więcej informacji znajdziesz w sekcji Parametry systemu.
Wartość maski pola to lista ścieżek do pól rozdzielonych przecinkami. Każda ścieżka pola to lista nazw pól rozdzielonych kropkami, które reprezentują hierarchię wiadomości. Nazwa pola to klucz obiektu JSON lub nazwa tagu pola protokołu buforowanego. Ścieżka pola zaczyna się od typu wiadomości odpowiedzi najwyższego poziomu, a następnie opcjonalnie zawiera co najmniej jedną kropkę i nazwę pola następnego poziomu. Ścieżki pól są zwykle tworzone w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Specjalnym przypadkiem maski pola jest symbol wieloznaczny „*”, który wybiera wszystkie pola najwyższego poziomu.
Aby dowiedzieć się więcej, zobacz:
Przykłady użycia metody ComputeCustomRoutes znajdziesz w artykule Przykłady obliczania trasy niestandardowej (wersja beta).
Obliczanie opłat za przejazd
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.