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 |
|---|---|---|
|
|
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:
- Skonfiguruj projekt: upewnij się, że projekt Google Cloud został utworzony i włączony dla Routes API.
- 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.
- Utwórz żądanie: wywołaj punkt końcowy
computeRouteslubcomputeRouteMatrixz parametremtravelModeustawionym naTRUCK, ustaw parametrroutingPreferencenaTRAFFIC_AWARE_OPTIMALi określ atrybuty pojazdu za pomocą obiektuvehicleInfo. - Podaj szczegółowe wskazówki dojazdu (opcjonalnie): jeśli wywołano
computeRoutes, przekażrouteTokenz 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.