Przy wyznaczaniu najlepszej trasy na wspólne przejazdy, najszybsza trasa nie zawsze musi być najlepszym rozwiązaniem. Możesz zaplanować trasę.
Interfejs Routes Preferred API umożliwia planowanie trasy przez określenie jej celu za pomocą metody ComputeCustomRoutes.
Metoda ComputeCustomRoutes pomaga również zachować zgodność z trasami, ponieważ pozwala zminimalizować różnicę między trasą wybraną przez operatora a wyznaczoną trasą.
Korzystaj zarówno z interfejsu Routes Preferred API, jak i z pakietu SDK nawigacji, aby w pełni wykorzystać możliwości planowania trasy.
Włączanie metody ComputeCustomRoutes
Zanim użyjesz w kodzie metody ComputeCustomRoutes, musisz ją włączyć. Więcej informacji o włączaniu preferowanych metod interfejsu API tras znajdziesz w pierwszych krokach.
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 sekcji Parametry systemu.
Wartość maski pola to rozdzielana przecinkami lista ścieżek pól. Każda ścieżka pola ma rozdzielaną kropkami listę nazw pól reprezentujących 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. Ogólnie ścieżki pól są konstruowane w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Maska pola 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 sekcji Obliczanie niestandardowej trasy (beta).
Obliczam opłaty za przejazd
Aby dowiedzieć się, jak obliczać opłaty, przeczytaj artykuł Obliczanie opłat drogowych.
Przykłady obliczania opłat drogowych znajdziesz w sekcji Obliczanie niestandardowych tras.