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 (ETA) dla dużych pojazdów. Zwraca zoptymalizowane trasy, które omijają ograniczenia na podstawie wysokości, wagi i długości pojazdu oraz klasyfikacji materiałów niebezpiecznych. Usługa generuje też token trasy, który można przekazać do pakietu Navigation SDK, aby zapewnić 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 flot dużych pojazdów.

Korzyść Opis
Zwiększanie dokładności cen i planowania Generuj szczegółowe, uwzględniające natężenie ruchu szacowane czasy dotarcia, które pozwalają dokładniej określać ceny i okna dostawy dla dużych pojazdów, takich jak ciężarówki i autobusy.
Zwiększanie bezpieczeństwa i wydajności kierowców Kieruj kierowców po trasach, które omijają niskie mosty, drogi z ograniczeniami wagi i inne zagrożenia.
Usprawnianie operacji w całej flocie Używaj optymalizacji tras wraz z wyznaczaniem tras dla dużych pojazdów, aby optymalizować przydział ł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.
Minimalizowanie szkoleń i zwiększanie adopcji Zaoferuj kierowcom dużych pojazdów lub ciężarówek znajome wrażenia z nawigacji w Mapach Google w swojej aplikacji.

Co możesz zrobić za pomocą wyznaczania tras dla dużych pojazdów

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

  • Określaj szczegółowe właściwości pojazdu, w tym wysokość, wagę, długość, szerokość, liczbę osi i klasyfikacje towarów niebezpiecznych.
  • Uzyskuj trasę, czas podróży i odległość obliczone specjalnie na podstawie atrybutów pojazdu.
  • Generuj trasy zoptymalizowane pod kątem manewrowania , automatycznie unikając zawracania i preferując autostrady. Dzięki temu duże pojazdy poruszają się po trasach, które uwzględniają potrzeby i oczekiwania kierowców.
  • Obliczaj dokładniejszy szacowany czas dotarcia za pomocą modelu ETA dla ciężarówek. Model łączy obserwowane prędkości podróży ciężarówek z danymi o natężeniu ruchu w czasie rzeczywistym i danymi prognostycznymi, aby zapewnić dokładniejsze szacunki dla dużych pojazdów.
  • Włączaj szczegółowe wskazówki dojazdu w pakiecie Navigation SDK za pomocą tokena trasy, aby przenieść bezpieczną dla ciężarówek trasę 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 w całej flocie.
  • Optymalizuj plan trasy dla 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 za pomocą tych usług:

Punkt końcowy Operacja Wyniki
Routes API Żądanie HTTPS do punktu końcowego Routes API (computeRoutes lub computeRouteMatrix) z treścią żądania, która zawiera punkt początkowy i docelowy. travelMode musi być ustawiony na TRUCK, a obiekt routeModifiers musi zawierać 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. travelMode musi być ustawiony na TRUCK, a obiekt routeModifiers musi zawierać 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 uwzględnij token trasy (wygenerowany przez 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 zgodne z informacjami o pojeździe podanymi w pierwotnym żądaniu Routes API lub Route Optimization API.

Przykład

Ten przykład pokazuje, jak korzystać z wyznaczania tras dla dużych pojazdów w interfejsie 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: w żądaniu musisz ustawić travelMode na TRUCK i wypełnić vehicleInfo obiekt konkretnymi wymiarami i atrybutami pojazdu.

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

Treść żądania i odpowiedzi

W tabeli poniżej znajdziesz listę danych, które wysyłasz i odbierasz podczas wysyłania żądania wyznaczania tras dla dużych pojazdów za pomocą metody computeRoutes w Routes API.

Treść żądania Treść odpowiedzi Format zwracanych danych
  • Współrzędne punktu początkowego i docelowego.
  • Obiekt vehicleInfo zawierający wymiary, wagę i typy materiałów niebezpiecznych pojazdu.
  • Linia łamana trasy.
  • Czas podróży i distanceMeters dla ciężarówki.
  • routeToken do użycia z pakietem Navigation SDK.
  • Obiekt travelAdvisory wskazujący, 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 sąsiadujących ze sobą stanach USA (dostępność ogólna) i Japonii (wersja eksperymentalna). Nie jest dostępne na Alasce, Hawajach ani na terytoriach USA.
  • Informacje dla kierowców i bezpieczeństwo. Kierowcy nie mogą polegać wyłącznie na trasach zwracanych przez ten interfejs API, aby zapewnić bezpieczeństwo i zgodność z przepisami. Nie ma gwarancji, że trasy będą odpowiednie dla pojazdu, a ich pokonywanie może narażać kierowców na zagrożenia, takie jak niskie mosty lub drogi, na których obowiązuje zakaz wjazdu dla dużych pojazdów.
  • Trasy w trybie możliwie najlepszej obsługi. 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ę w trybie „możliwie najlepszej obsługi”, która może przebiegać przez obszary objęte ograniczeniami. Odpowiedź Routes API wyraźnie oznacza te trasy w polu routeRestrictionsPartiallyIgnored. W takich przypadkach dokładnie zaplanuj trasę, najlepiej korzystając z innych źródeł danych. Nie używaj oznaczonej trasy jako jedynego źródła informacji na potrzeby planowania lub nawigacji.
  • Nieobsługiwane funkcje: wyznaczanie tras dla dużych pojazdów nie obsługuje tych funkcji:
    • ceny za przejazd dla ciężarówek;
    • ograniczenia prędkości;
    • wyznaczanie tras dla radioaktywnych materiałów niebezpiecznych.
  • Limity użycia: 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 w interfejsie Routes API:

  1. Skonfiguruj projekt w chmurze: upewnij się, że projekt Google Cloud został utworzony i włączony w Routes API.
  2. Zapewnij wyznaczanie tras dla dużych pojazdów: wyznaczanie tras dla dużych pojazdów jest dostępne tylko dla niektórych klientów. Skontaktuj się z nami, aby poprosić o dostęp i skonfigurować projekt pod kątem tej funkcji.
  3. Utwórz żądanie: wywołaj punkt końcowy computeRoutes lub computeRouteMatrix z ustawionym parametrem travelMode na TRUCK, ustaw routingPreference na TRAFFIC_AWARE_OPTIMAL i określ atrybuty pojazdu za pomocą obiektu vehicleInfo.
  4. Zapewnij szczegółowe wskazówki dojazdu (opcjonalnie): jeśli wywołasz computeRoutes, przekaż routeToken z odpowiedzi do pakietu Navigation SDK, aby rozpocząć sesję nawigacji.

Co dalej?

  • Zacznij: generuj trasy dla ciężarówek i szacowane czasy dotarcia za pomocą Routes API.
  • Dodaj nawigację: zapewnij szczegółowe wskazówki dojazdu z trasami dla ciężarówek w pakiecie Navigation SDK na Android lub iOS