Omówienie wyznaczania tras dla dużych pojazdów

Zdjęcie dużej ciężarówki na drodze

Funkcja wyznaczania tras dla dużych pojazdów w interfejsie Routes API oblicza trasy i szacowany czas dotarcia na miejsce dla dużych pojazdów. Zwraca zoptymalizowane trasy, które omijają ograniczenia związane z wysokością, wagą i długością pojazdu oraz klasyfikacją materiałów niebezpiecznych. Usługa generuje też token trasy, który można przekazać do pakietu Navigation SDK, aby uzyskać szczegółowe wskazówki dojazdu.

Dlaczego warto korzystać z wyznaczania tras dla dużych pojazdów

Korzystaj z wyznaczania tras dla dużych pojazdów, aby tworzyć aplikacje, które rozwiązują problemy logistyczne związane z flotami dużych pojazdów.

Korzyść Opis
Zwiększanie dokładności cen i planowania Generuj konkretne, oparte na danych o ruchu szacowane czasy dotarcia na miejsce, które pozwalają na dokładniejsze wyceny i określanie okien dostaw dla dużych pojazdów, takich jak ciężarówki i autobusy.
Zwiększanie bezpieczeństwa i wydajności kierowców Prowadź kierowców trasami, które omijają niskie mosty, drogi z ograniczeniami wagowymi i inne niebezpieczne miejsca.
Usprawnianie operacji w całej flocie Używaj optymalizacji trasy wraz z wyznaczaniem tras dla dużych pojazdów, aby optymalizować przydzielanie ładunków i kolejność przystanków dla całej floty. Używaj Fleet Engine, aby zapewnić widoczność przydziałów i lokalizacji pojazdów w czasie rzeczywistym.
Minimalizacja czasu szkolenia i zwiększenie akceptacji Zapewnij kierowcom dużych pojazdów lub ciężarówek znajomą nawigację w Mapach Google w swojej aplikacji.

Co możesz zrobić dzięki wyznaczaniu tras dla dużych pojazdów

Dzięki wyznaczaniu tras dla dużych pojazdów możesz wykonywać te kluczowe operacje:

  • Określ szczegółowe właściwości pojazdu, takie jak wysokość, waga, długość, szerokość, liczba osi i klasyfikacja towarów niebezpiecznych.
  • Uzyskaj trasę, czas podróży i odległość obliczone specjalnie na podstawie atrybutów pojazdu.
  • Generuj trasy zoptymalizowane pod kątem manewrowości, automatycznie unikając zawracania i preferując autostrady i drogi szybkiego ruchu. Dzięki temu duże pojazdy poruszają się po trasach, które odpowiadają potrzebom i oczekiwaniom ich kierowców.
  • Obliczaj dokładniejszy szacowany czas dotarcia na miejsce, korzystając z modelu szacowanego czasu dotarcia na miejsce dla ciężarówek. Model łączy zaobserwowane prędkości jazdy ciężarówek z danymi o natężeniu ruchu w czasie rzeczywistym i danymi prognostycznymi, aby zapewnić dokładniejsze szacunki dotyczące dużych pojazdów.
  • Włącz szczegółowe wskazówki dojazdu w pakiecie Navigation SDK, używając tokena trasy, aby przenieść trasę bezpieczną dla ciężarówek z interfejsu Routes API.
  • Obliczaj macierze tras, aby określać czas podróży i odległości między wieloma punktami początkowymi i docelowymi na potrzeby planowania dla całej floty.
  • Zoptymalizuj plan trasy dla swojej floty ciężarówek pod kątem ogólnej wydajności operacyjnej, która uwzględnia wykonalność i bezpieczeństwo.

Jak działa wyznaczanie tras dla dużych pojazdów

Funkcja wyznaczania tras dla dużych pojazdów działa w ramach tych usług:

Punkt końcowy Operacja Wyniki
Routes API Żądanie HTTPS do punktu końcowego interfejsu Routes API (computeRoutes lub computeRouteMatrix) z treścią żądania zawierającą miejsce rozpoczęcia i zakończenia podróży. Właściwość travelMode musi mieć wartość TRUCK, a obiekt routeModifiers musi zawierać właściwość vehicleInfo. linia łamana trasy, lista odcinków i kroków trasy, szacowany czas podróży oraz token trasy;
Route Optimization API żądanie HTTPS do punktu końcowego Route Optimization API, Właściwość travelMode musi mieć wartość TRUCK, a obiekt routeModifiers musi zawierać właściwość vehicleInfo. Zoptymalizowany plan trasy dla floty zaprojektowany dla konkretnego pojazdu oraz tokeny trasy dla każdej podróży.
Navigation SDK (Android, iOS) Podczas ustawiania miejsc docelowych w nawigatorze dołącz token trasy (wygenerowany przez interfejs Routes API lub Route Optimization API z wyznaczaniem tras dla dużych pojazdów). Szczegółowe wskazówki dojazdu dostosowane do ciężarówek i wyznaczające trasę zgodnie z informacjami o pojeździe podanymi w pierwotnym żądaniu do interfejsu Routes API lub Route Optimization API.

Przykład

W tym przykładzie skupiamy się na wyznaczaniu tras dla dużych pojazdów za pomocą interfejsu Routes API.

Na przykład podstawowa treść żądania computeRoutes wygląda tak:

{
  "origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
  "destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
  "travelMode": "TRUCK",
  "routeModifiers": {
    "vehicleInfo": {
      "totalHeightMm": 4114,
      "totalLengthMm": 21945,
      "totalWeightKg": 32658,
      ... // other vehicle attributes
    }
  }
}

Wymagane: żądanie musi ustawić parametr travelMode na TRUCK i wypełnić obiekt vehicleInfo konkretnymi wymiarami i atrybutami pojazdu.

Interfejs Routes API zwraca trasę, która uwzględnia podane informacje o pojeździe. Odpowiedź może zawierać linię łamaną trasy, szacowany czas dotarcia na miejsce dla ciężarówki, odległość i token trasy do użycia z pakietem Navigation SDK, w zależności od określonej maski pola. Odpowiedź wskazuje też, czy nie można znaleźć w pełni zgodnej trasy.

Treść żądania i odpowiedzi

W tabeli poniżej znajdziesz dane, które wysyłasz i otrzymujesz, gdy wysyłasz żądanie wyznaczania trasy dla dużego pojazdu za pomocą metody computeRoutes interfejsu Routes API.

Treść żądania Treść odpowiedzi Format zwracanych danych
  • Współrzędne miejsca początkowego i docelowego.
  • Obiekt vehicleInfo zawierający wymiary i wagę pojazdu oraz typy materiałów niebezpiecznych.
  • Linia łamana trasy.
  • Czas podróży ciężarówką i distanceMeters.
  • routeToken do użycia z pakietem Navigation SDK.
  • Obiekt travelAdvisory, który wskazuje, czy routeRestrictionsPartiallyIgnored.
JSON

Ograniczenia

Zanim zaczniesz, musisz zapoznać się z tymi ograniczeniami i wymaganiami.

  • Dostępność geograficzna: wyznaczanie tras dla dużych pojazdów jest dostępne w 48 stanach kontynentalnych USA (ogólna dostępność) i w Japonii (funkcja eksperymentalna). Nie jest dostępna na Alasce, Hawajach ani na terytoriach zależnych USA.
  • Wskazówki i bezpieczeństwo kierowcy. Kierowcy nie powinni polegać wyłącznie na trasach zwracanych przez ten interfejs API, aby zapewnić bezpieczeństwo lub zgodność z prawem. Nie ma gwarancji, że trasy będą odpowiednie dla pojazdu, a podążanie nimi może narazić kierowców na niebezpieczeństwa, takie jak niskie mosty lub drogi, na których obowiązuje zakaz ruchu dużych pojazdów.
  • Trasy typu „best-effort”. W niektórych przypadkach interfejs API nie może znaleźć trasy, która w pełni spełnia ograniczenia dotyczące podróży. Zamiast tego zwraca trasę „najlepszej obsługi”, która może nadal przebiegać przez obszary z ograniczeniami. Odpowiedź interfejsu Routes API wyraźnie oznacza te trasy w polu routeRestrictionsPartiallyIgnored. W takich przypadkach starannie zaplanuj trasę, najlepiej korzystając z innych źródeł danych. Nie używaj oznaczonej trasy jako jedynego źródła wiarygodnych danych do planowania lub nawigacji.
  • Nieobsługiwane funkcje: wyznaczanie tras dla dużych pojazdów nie obsługuje tych funkcji:
    • Opłaty za przejazd ciężarówek
    • Ograniczenia prędkości
    • Trasa dla materiałów niebezpiecznych radioaktywnych
  • Limity wykorzystania: wszystkie żądania podlegają standardowym limitom zapytań na sekundę (QPS).

Jak korzystać z wyznaczania tras dla dużych pojazdów

Aby korzystać z wyznaczania tras dla dużych pojazdów za pomocą interfejsu Routes API, wykonaj te czynności:

  1. Skonfiguruj projekt: upewnij się, że projekt Google Cloud został utworzony i włączony dla Routes API.
  2. Udostępnianie wyznaczania tras dla dużych pojazdów: wyznaczanie tras dla dużych pojazdów jest dostępne dla ograniczonej liczby klientów. Skontaktuj się z nami, aby poprosić o dostęp i udostępnić tę funkcję w swoim projekcie.
  3. Utwórz żądanie: wywołaj punkt końcowy computeRoutes lub computeRouteMatrix z parametrem travelMode ustawionym na TRUCK, ustaw parametr routingPreference na TRAFFIC_AWARE_OPTIMAL i określ atrybuty pojazdu za pomocą obiektu vehicleInfo.
  4. Podaj szczegółowe wskazówki dojazdu (opcjonalnie): jeśli wywołano computeRoutes, przekaż routeToken z odpowiedzi do pakietu Navigation SDK, aby rozpocząć sesję nawigacji.

Co dalej?

  • Pierwsze kroki: generowanie tras dla ciężarówek i szacowanego czasu dotarcia na miejsce za pomocą interfejsu Routes API
  • Dodaj nawigację: udostępniaj szczegółowe wskazówki dojazdu trasami dla ciężarówek za pomocą pakietu Navigation SDK na Android lub iOS.