Czasami możesz chcieć zaplanować trasę, jaką Twoja aplikacja dociera do użytkowników. Korzystając z tokenu trasy z interfejsu Routes API, Routes Preferred API lub Route Optimization API, możesz określić 2 rzeczy dla zaplanowanej trasy:
Linia łamana trasy
Cele trasy
Oto kilka przykładów celów kierowania:
Zminimalizowanie czasu dostawy: firma dostarczająca jedzenie może chcieć zminimalizować czas potrzebny na dostarczenie posiłku.
Minimalizacja czasu podróży i zużycia paliwa: firma logistyczna może chcą zwiększyć wydajność kierowców i obniżyć koszty paliwa.
Minimalizowanie czasu dojazdu do miejsca docelowego: operacja zlecenia usługi może chcieć zminimalizować czas potrzebny operatorom na dotarcie do miejsca wykonania zlecenia.
Obniżka kosztów i zwiększenie bezpieczeństwa: firma oferująca usługi przewozu osób może chcieć znaleźć trasę, która jest tańsza dla pasażerów i omija określone obszary ze względów bezpieczeństwa.
Więcej informacji o planowaniu trasy z użyciem tokena trasy znajdziesz w sekcji Wysyłanie żądania token trasy Interfejs Routes API oraz przenoszenie linii łamanych i trasy Tokeny w Interfejs Route Optimization API.
Dlaczego warto używać tokenu trasy do celów związanych z trasami
Za pomocą tokena trasy z interfejsu Routes API Preferowany interfejs API Trasy lub interfejs Route Optimization API, mają większą kontrolę nad trasą:
Zaplanuj z wyprzedzeniem trasę, której pakiet Navigation SDK będzie używany podczas jak to tylko możliwe.
Wybierz najlepszą trasę do użycia przez pakiet SDK nawigacji. Jeśli żądania tokenów tras podczas generowania tras w interfejsie Routes API, otrzymasz token trasy dla każdej wygenerowanej trasy. Następnie możesz wybrać token trasy, której chcesz użyć, gdy przekażesz ją do pakietu SDK nawigacji.
Oszacuj cenę z wyprzedzeniem, w tym szacowany czas dotarcia na miejsce i odległość. Rzeczywisty koszt i czas mogą się różnić, ale to oszacowanie zmniejsza między przewidywanym a rzeczywistym kosztem trasy.
określać bardziej zaawansowane cele trasy, takie jak wyznaczanie tras ekologicznych czy najkrótszą trasą.
Jak działają tokeny trasy
Do planowania trasy za pomocą celów trasy możesz użyć interfejsu Routes API, Routes Preferred API lub Route Optimization API. Ty mogą przekazać token trasy zwrócony z dowolnego z tych interfejsów API Pakiet SDK nawigacji pomaga kierować pojazdem.
Oto, co się dzieje, gdy żądasz i używasz tokenu trasy:
interfejs Routes API, preferowany interfejs Routes Preferred lub Interfejs Route Optimization API zwraca zaszyfrowany token trasy, zawiera cele linii łamanej trasy i cele.
Token trasy przekazujesz do Navigation SDK.
Pakiet Navigation SDK pobiera trasę lub jeśli trasa nie jest dostępny ze względu na zmianę warunków, pobiera najlepiej pasującą trasę.
Podczas przejazdu, jeśli zmieni się natężenie ruchu lub inne warunki drogowe albo pojazd zboczy z planowanej trasy, zmodyfikowane trasy będą stale próbować dopasować się do najlepszej trasy na podstawie celów trasy w tokenie.
Ten proces pozwala zmaksymalizować odległość między rzeczywistą trasą a planowaną trasą.
Dlaczego zaplanowana trasa może nie zostać dokładnie przemierzona
Zaplanowaną trasę i cele trasy należy traktować jak wytyczne do przestrzegania: nie są wymogiem. Możesz zauważyć różnicę między zaplanowaną trasą trasa wyznaczona w ramach nawigacji z powodu różnic na drodze warunków, lokalizacji początkowej lub innych parametrów, które uległy zmianie od utworzył zaplanowaną trasę. Ta różnica może powodować niezgodność między planowane i rzeczywiste cele związane z odległością i szacowanym czasem dotarcia na miejsce i odtwarzania.
Planowanie trasy za pomocą tokenu trasy
Możesz zaplanować trasę, tworząc token trasy i przekazując go do pakietu SDK nawigacji w ten sposób:
Krok 1. Utwórz token trasy za pomocą interfejsu Routes API, Routes Preferred API lub interfejsu Route Optimization API
Poproś o token trasy, korzystając z jednej z tych metod:
Routes API:
computeRoutes. Więcej informacji żądania tokena trasy w interfejsie Routes API znajdziesz w artykule Obliczanie trasy i Zażądaj trasy .Preferowany interfejs API tras:
computeCustomRoutes. Więcej o żądaniu tokena trasy w sekcji Preferowany interfejs API tras. Więcej informacji znajdziesz w sekcji Planowanie .Route Optimization API:
optimizeTourslubbatchOptimizeTours. Więcej informacji o wysyłaniu żądania tokenu trasy w interfejsie Route Optimization API znajdziesz w artykule Przechodzenie na ścieżkę wielokątną i tokeny trasy.
Skonfiguruj interfejs Routes API lub Routes Preferred API, aby spełnić wymagania dotyczące używania tokenu trasy:
- Ustaw
travel_modenaDRIVINGlubTWO_WHEELER - Ustaw wartość
routing_preferencenaTRAFFIC_AWARElubTRAFFIC_AWARE_OPTIMAL - NIE używaj punktów na trasie
Via
- Ustaw
Krok 2. Przekaż token trasy do pakietu Navigation SDK
Przechowuj token trasy: w pakiecie Navigation SDK skonfiguruj ciąg znaków do przechowywania tokenu trasy. Na przykład:
String routeToken = "route token returned by Routes API";
Przykład zwróconego tokenu trasy:
{ // Other fields "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g", }Przekaż token trasy do pakietu Navigation SDK za pomocą Metoda
Navigator.setDestinations, określająca to samo miejsce docelowe punkty pośrednie użyte podczas tworzenia tokena trasy:setDestinations(List
destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions); Na przykład:
CustomRoutesOptions customRoutesOptions = CustomRoutesOptions.builder() .setRouteToken(routeToken) .setTravelMode(TravelMode.DRIVING) .build();
Metoda Navigator.setDestinations zwraca stan żądania. Jeśli
znajduje trasę z lokalizacji pojazdu do danego miejsca docelowego,
zwraca RouteStatus.OK.
Więcej informacji o tej metodzie znajdziesz w artykule Navigator.setDestinations.
Przykład
Poniższy przykładowy kod pokazuje, jak określić zaplanowaną trasę za pomocą tokena trasy.
ArrayList <Waypoint> destinations = Lists.newArrayList();
Waypoint waypoint1 =
Waypoint.builder()
.setLatLng(10, 20)
.setTitle("title")
.setVehicleStopover(true)
.build();
destinations.add(waypoint1);
Waypoint waypoint2 =
Waypoint.builder()
.setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
.setTitle("title")
.setVehicleStopover(true)
.build()
destinations.add(waypoint2);
String routeToken = "route token returned by Routes API";
CustomRoutesOptions customRoutesOptions =
CustomRoutesOptions.builder()
.setRouteToken(routeToken)
.setTravelMode(TravelMode.DRIVING)
.build();
// Existing flow to get a Navigator.
NavigationApi.getNavigator(...);
// Existing flow for requesting routes.
ListenableResultFuture<RouteStatus> routeStatusFuture =
navigator.setDestinations(destinations, customRoutesOptions);
// Or with display options.
DisplayOptions displayOptions = new DisplayOptions();
ListenableResultFuture<RouteStatus> routeStatusFuture =
navigator.setDestinations(destinations, customRoutesOptions, displayOptions);
Interakcje tokenów trasy z pakietem SDK nawigacji
Trasa wygenerowana przez pakiet Navigation SDK oraz planowana trasa w tokenie trasy:
Zastępuje wszystkie wcześniej ustawione miejsca docelowe.
Używa lokalizacji początkowej pojazdu.
Dostosowuje do warunków na drodze i natężeniu ruchu. Zobacz Dlaczego zaplanowana trasa może nie być dokładnie przemierzona.
Ignoruje te opcje związane z przekierowywaniem, ponieważ są niepotrzebne:
avoidsHighwaysavoidsTollsavoidsFerrieslicensePlateRestriction
Obserwatorzy:
Opcje związane z punktami pośrednimi, takie jak preferencja pobocznej drogi.
Cele trasy. Jeśli pakiet Navigation SDK musi i dostosuje zwrócona trasa, korzysta z celów trasy określonych podczas żądania tokena trasy. Z tego powodu należy używać tych samych opcji dotyczących punktów pośrednich, które zostały określone w interfejsie Routes API.