Gdy wybierasz najlepszą trasę w ramach wspólnych przejazdów, najszybsza trasa nie zawsze jest najlepszym rozwiązaniem. Zaplanuj trasę.
Interfejs Routes Preferred API pozwala zaplanować trasę przez określenie jej celu za pomocą metody ComputeCustomRoutes.
Metoda ComputeCustomRoutes pomaga też w zapewnieniu zgodności trasy, ponieważ pozwala zminimalizować różnicę między trasą wybraną przez operatora a przejechaną trasą.
Aby w pełni korzystać z możliwości planowania tras, użyj zarówno interfejsu Routes Preferred API, jak i pakietu SDK nawigacji.
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 wprowadzeniu.
Użyj metody ComputeCustomRoutes
Metoda ComputeCustomRoutes wymaga określenia maski pola odpowiedzi w danych wejściowych. Maską pola odpowiedzi możesz podać przy użyciu 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 jest listą ścieżek pól rozdzielonych przecinkami. Każda ścieżka pól to oddzielona kropkami listą nazw pól, które reprezentują hierarchię wiadomości. Nazwa pola to klucz obiektu JSON lub nazwa tagu pola protobuf. Ścieżka pola rozpoczyna się od typu komunikatu odpowiedzi najwyższego poziomu, po czym opcjonalnie może następować 1 lub więcej kropek, a następnie następny poziom nazwy pola. Ogólnie ścieżki pól są tworzone w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Maska pola specjalnego przypadku to symbol wieloznaczny „*”, który powoduje zaznaczenie wszystkich pól na poziomie głównym.
Aby dowiedzieć się więcej, zobacz:
Przykłady użycia metody ComputeCustomRoutes znajdziesz w artykule o obliczaniu niestandardowej trasy (beta).
Obliczanie opłat drogowych
Więcej informacji o obliczaniu opłat drogowych znajdziesz w artykule Obliczanie opłat drogowych.
Przykłady obliczania opłat drogowych znajdziesz w artykule Obliczanie przykładów tras niestandardowych.