Zaplanuj trasę

Czasami możesz chcieć zaplanować trasę, którą Twoja aplikacja będzie udostępniać użytkownikom. 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 dla trasy

• Cele trasy

Oto przykładowe cele kierowania, które możesz stosować:

• Minimalizowanie czasu dostawy: firma dostarczająca jedzenie może chcieć zminimalizować czas potrzebny na dostarczenie posiłku.

• Minimalizowanie czasu podróży lub zużycia paliwa: firma logistyczna może chcieć zwiększyć wydajność kierowców i obniżyć koszty paliwa.

• Minimalizowanie czasu dojazdu do miejsca docelowego: operacja zlecania usługi może chcieć zminimalizować czas potrzebny operatorom na dotarcie do miejsca wykonania zlecenia.

• Niższe koszty i większe bezpieczeństwo: firma oferująca usługi wspólnych przejazdów może chcieć znaleźć trasę, która będzie tańsza dla pasażerów i ze względów bezpieczeństwa omija niektóre obszary.

Ważne: rzeczywisty przebyty szlak może różnić się od zaplanowanego szlaku podanego w tokenie. Zmiany trasy mogą być spowodowane przez zmieniający się ruch, warunki na drodze lub odstępstwo od danej trasy. W miarę pojawiania się zmian pakiet SDK nawigacji stale próbuje wrócić do zaplanowanej trasy. Jeśli nie jest to możliwe, stosuje cele trasy podane w tokenie trasy.

Więcej informacji o planowaniu trasy za pomocą tokenu trasy znajdziesz w artykule Wysyłanie żądania dotyczącego tokenu trasy w interfejsie Routes API oraz w artykule Przejście na polilinie i tokeny trasy w interfejsie Route Optimization API.

Dlaczego warto używać tokenu trasy do celów związanych z trasami

Dzięki tokenowi trasy z interfejsu Routes API, Routes Preferred API lub Route Optimization API masz większą kontrolę nad podaną trasą:

• Zaplanuj trasę z wyprzedzeniem, aby pakiet SDK do nawigacji mógł go użyć, gdy to możliwe.

• Wybierz najlepszą trasę dla pakietu SDK do nawigacji. Jeśli podczas generowania tras w interfejsie Routes API żądasz tokenów trasy, 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 szacowane przybliżone przybycie i odległość. Rzeczywisty koszt i czas mogą się różnić, ale dzięki tej szacowanej wartości różnica między oczekiwanym a rzeczywistym kosztem trasy jest mniejsza.

• określać bardziej zaawansowane cele trasy, takie jak wyznaczanie trasy przyjaznej dla środowiska lub najkrótszej trasy;

Wskazówka: token trasy dotyczy jednego konkretnego miejsca pochodzenia i docelowego w określonym czasie. Dla nowego tokena trasy musisz utworzyć nowe żądanie interfejsu Routes API, Preferred API lub Route Optimization API.

Jak działają tokeny tras

Do planowania trasy za pomocą celów trasy możesz użyć interfejsu Routes API, Routes Preferred API lub Route Optimization API. Do pakietu SDK nawigacji możesz przekazać token trasy zwrócony przez dowolny z tych interfejsów API, aby określić, jak ma on wyznaczać trasę dla pojazdu.

Oto, co się dzieje, gdy żądasz i używasz tokenu trasy:

1. Interfejsy Routes API, Routes Preferred API lub Route Optimization API zwracają zaszyfrowany token trasy, który zawiera polilinie trasy i cele trasy.

2. Token trasy przekazujesz do pakietu Navigation SDK.

3. Pakiet Navigation SDK pobiera trasę, a jeśli trasa jest niedostępna z powodu zmieniających się warunków, pobiera najlepiej pasującą trasę.

4. Podczas jazdy, gdy zmieniają się natężenie ruchu lub inne warunki drogowe albo pojazd odbiega od zaplanowanej trasy, zmodyfikowane trasy cały czas próbują dopasować najlepszą trasę na podstawie celów trasy określonych 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 jej cele traktuj jako wskazówki: nie są one wiążące. Możesz zauważyć różnicę między zaplanowaną trasą a trasą wyświetlaną przez nawigację prowadzoną z powodu różnic w warunkach na drodze, lokalizacji początkowej lub innych parametrów, które uległy zmianie od momentu utworzenia zaplanowanej trasy. Ta różnica może spowodować rozbieżność między planowanymi a rzeczywistymi celami dotyczącymi odległości i przewidywanego czasu dojazdu, a także innymi ważnymi parametrami podróży.

Wskazówka: zgodnie ze sprawdzonymi metodami za każdym razem, gdy ustawiasz miejsce docelowe w pakiecie Navigation SDK, żądaj nowego tokena trasy i zaplanuj jakąś odmianę, aby nie wpłynęło to na działalność Twojej firmy.

Planowanie trasy z użyciem tokena 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 Route Optimization API

1. Poproś o token trasy, korzystając z jednej z tych metod:

   • Interfejs Routes API: computeRoutes. Więcej informacji o wykonywaniu żądania tokenu trasy w interfejsie Routes API znajdziesz w artykułach Obliczanie trasy i Wysyłanie żądania tokenu trasy.

   • Routes Preferred API: computeCustomRoutes. Więcej informacji o wysyłaniu żądania tokenu trasy w interfejsie Routes Preferred API znajdziesz w artykule Planowanie trasy.

   • Route Optimization API: optimizeTours lub batchOptimizeTours. 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.

2. Skonfiguruj interfejs Routes API lub Routes Preferred API, aby spełnić wymagania dotyczące używania tokenu trasy:

   • Ustaw wartość travel_mode na DRIVING lub TWO_WHEELER
   • Ustaw wartość routing_preference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL
   • NIE UŻYWAJ punktów pośrednich Via

Krok 2. Przekaż token trasy do pakietu Navigation SDK

1. 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",
   }
   

2. Przekazuj token trasy do pakietu SDK nawigacji za pomocą metody Navigator.setDestinations, podając te same punkty docelowe, które zostały użyte podczas tworzenia tokenu trasy:

   setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

   Na przykład:

   CustomRoutesOptions customRoutesOptions =
         CustomRoutesOptions.builder()
         .setRouteToken(routeToken)
         .setTravelMode(TravelMode.DRIVING)
         .build();

Uwaga: jeśli chcesz ponownie podróżować tą samą trasą, poproś o nowy token trasy.

Metoda Navigator.setDestinations zwraca stan żądania. Jeśli znajdzie trasę z lokalizacji pojazdu do podanego miejsca docelowego, zwróci wartość RouteStatus.OK.

Więcej informacji o tej metodzie znajdziesz na stronie Navigator.setDestinations.

Przykład

Poniższy przykładowy kod pokazuje, jak określić zaplanowaną trasę za pomocą tokenu 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 do nawigacji

Oto jak trasa wygenerowana przez pakiet SDK do nawigacji i planowana trasa w tokenie trasy ze sobą współdziałają:

• Zastępuje wszystkie wcześniej ustawione miejsca docelowe.

• Używa lokalizacji początkowej pojazdu.

• Dostosowanie do warunków na drodze i natężenia ruchu. Dowiedz się, dlaczego samochód może nie jechać dokładnie wyznaczoną trasą.

• Ignoruje te opcje związane z routingiem jako niepotrzebne:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• Obserwuje:

  • Opcje związane z punktami orientacyjnymi, np. preferencja dotycząca strony drogi.

  • Cele dotyczące tras. Jeśli pakiet SDK Nawigacji musi dostosować zwróconą trasę, używa do tego celów trasy określonych podczas żądania tokenu 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.