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 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łączanie metody ComputeCustomRoutes
Zanim zaczniesz używać metody ComputeCustomRoutes w kodzie, musisz ją włączyć. Więcej informacji o włączaniu metod interfejsu Routes Preferred API
znajdziesz w artykule Pierwsze kroki.
Korzystanie z metody ComputeCustomRoutes
Metoda ComputeCustomRoutes wymaga, aby w danych wejściowych określić maskę 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 systemowe.
Wartość maski pola to lista ścieżek pól oddzielonych przecinkami. Każda ścieżka pola to lista nazw pól oddzielonych kropkami, 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, a następnie opcjonalnie zawiera co najmniej 1 kropkę i nazwę pola następnego poziomu. Ogólnie ścieżki pól są tworzone w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Specjalnym przypadkiem maski pola jest symbol wieloznaczny „*”, który wybiera wszystkie pola najwyższego poziomu.
Więcej informacji znajdziesz w tych materiałach:
Przykłady użycia metody ComputeCustomRoutes znajdziesz w artykule
Przykłady obliczania trasy niestandardowej (wersja beta).
Obliczanie opłat za przejazd płatnymi drogami
Informacje o obliczaniu opłat za przejazd płatnymi drogami znajdziesz w artykule Obliczanie opłat za przejazd płatnymi drogami.
Przykłady obliczania opłat za przejazd płatnymi drogami znajdziesz w artykule Przykłady obliczania trasy niestandardowej.