Podczas określania najlepszej trasy dla przejazdu z udostępniania przejazdu najszybsza trasa nie zawsze jest najlepszą opcją. 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, pozwalając zminimalizować różnicę między trasą wybraną przez operatora a wyznaczoną trasą.
Aby w pełni korzystać z planowania tras, używaj zarówno interfejsu Routes Preferred API, jak i pakietu SDK Nawigacji.
Włączanie metody ComputeCustomRoutes
Zanim użyjesz metody ComputeCustomRoutes w kodze, 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 maski 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 systemu.
Wartość maski pola to rozdzielana przecinkami lista ścieżek pól. Każda ścieżka pola jest listą nazw pól rozdzielonych kropkami, która reprezentuje 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. Ścieżki pól są zazwyczaj konstruowane w ten sposób:
topLevelField[.secondLevelField][.thirdLevelField][...]
Maska pola przypadku specjalnego to symbol wieloznaczny „*”, który wybiera wszystkie pola na poziomie głównym.
Aby dowiedzieć się więcej, zobacz:
Przykłady korzystania z metody ComputeCustomRoutes znajdziesz w artykule Przykłady obliczania trasy niestandardowej (beta).
Obliczanie opłat za przejazd autostradą
Aby dowiedzieć się, jak obliczać opłaty drogowe, przeczytaj artykuł Obliczanie opłat drogowych.
Przykłady obliczania opłat za przejazd znajdziesz w artykule Przykłady obliczania trasy niestandardowej.