Funkcja interfejsu Routes API wyznaczania tras dla pojazdów wielkogabarytowych oblicza trasy i szacowany czas dotarcia na miejsce dla pojazdów wielkogabarytowych. Zwraca zoptymalizowane trasy, które omijają ograniczenia dotyczące 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ółową nawigację.
Dlaczego warto korzystać z wyznaczania tras dla dużych pojazdów
Korzystaj z wyznaczania tras dla dużych pojazdów, aby tworzyć aplikacje rozwiązujące problemy logistyczne flot dużych pojazdów.
| Korzyść | Opis |
|---|---|
| Zwiększanie dokładności cen i planowania | Generowanie konkretnych, opartych na danych o ruchu szacowanych czasów dotarcia na miejsce, które pozwalają na dokładniejsze wyceny i określanie przedziałów czasowych dostawy w przypadku dużych pojazdów, takich jak ciężarówki i autobusy. |
| Zwiększanie bezpieczeństwa i wydajności kierowców | Prowadź 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ć przypisywanie ładunków i kolejność przystanków dla całej floty. Używaj Fleet Engine, aby w czasie rzeczywistym śledzić przydzielone zadania i lokalizacje pojazdów. |
| Zminimalizuj szkolenia i zwiększaj liczbę użytkowników | Zapewnij kierowcom dużych pojazdów lub ciężarówek znajomą nawigację w Mapach Google w Twojej aplikacji. |
Co możesz robić za pomocą routingu 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.
- Generowanie tras zoptymalizowanych pod kątem zwrotności przez automatyczne unikanie zawracania i preferowanie autostrad. Dzięki temu duże pojazdy będą poruszać się po trasach, które spełniają potrzeby i oczekiwania kierowców.
- Obliczaj dokładniejszy szacowany czas dotarcia na miejsce za pomocą modelu szacowania czasu dotarcia na miejsce dostosowanego do samochodów ciężarowych. Model łączy obserwowane prędkości ciężarówek z danymi o ruchu w czasie rzeczywistym i danymi prognostycznymi, aby zapewnić dokładniejsze szacunki dla 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.
- Optymalizuj plan trasy dla floty ciężarówek pod kątem ogólnej wydajności operacyjnej, z uwzględnieniem wykonalności i bezpieczeństwa.
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 początkowe i docelowe. Wartość travelMode musi być ustawiona na TRUCK, a obiekt routeModifiers musi zawierać vehicleInfo.
|
linię łamaną trasy, listę odcinków i kroków trasy, szacowany czas podróży oraz token trasy. |
| Route Optimization API | Żądanie HTTPS do punktu końcowego interfejsu 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 uwzględnij token trasy (wygenerowany w interfejsie Routes API lub Route Optimization API z funkcją wyznaczania tras dla dużych pojazdów). | Szczegółowe wskazówki dojazdu dostosowane do ciężarówek i podążające trasą zgodną z informacjami o pojeździe określonymi w pierwotnym żądaniu do interfejsu Routes API lub Route Optimization API. |
Przykład
Poniższy przykład pokazuje, jak korzystać z wyznaczania tras dla dużych pojazdów za pomocą interfejsu Routes API.
Na przykład podstawowa computeRoutestreść żądania 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ć wartość 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 SDK Navigation, w zależności od określonej maski pola. Odpowiedź wskazuje też, czy nie można znaleźć trasy w pełni zgodnej z przepisami.
Treść żądania i odpowiedzi
W tabeli poniżej znajdziesz listę danych, które wysyłasz i otrzymujesz podczas wysyłania żądania dotyczącego wyznaczania tras dla dużych pojazdów za pomocą metody computeRoutes interfejsu Routes API.
| Treść żądania | Treść odpowiedzi | Format zwrotu |
|---|---|---|
|
|
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 (ogólnie dostępne) i w Japonii (eksperymentalnie). Nie jest dostępna na Alasce, Hawajach ani na terytoriach zależnych USA.
- Porady i bezpieczeństwo kierowcy Kierowcy nie mogą polegać wyłącznie na trasach zwracanych przez ten interfejs API, aby zapewnić bezpieczeństwo lub zgodność z przepisami. Trasy nie zawsze są odpowiednie dla danego pojazdu, a podążanie nimi może narażać kierowców na niebezpieczeństwa, takie jak niskie mosty lub drogi, na których poruszanie się dużymi pojazdami jest zabronione.
- Trasy typu „best-effort”. W niektórych przypadkach interfejs API nie może znaleźć trasy, która w pełni spełnia wymagania dotyczące ograniczeń w podróżowaniu. Zamiast tego zwraca trasę „możliwie najlepszą”, 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 na potrzeby planowania lub nawigacji. - Nieobsługiwane funkcje: wyznaczanie tras dla dużych pojazdów nie obsługuje:
- Opłaty za przejazd ciężarówek
- Ograniczenia prędkości
- Trasy przewozu radioaktywnych materiałów niebezpiecznych
- Limity wykorzystania: wszystkie żądania podlegają standardowym limitom zapytań na sekundę.
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:
- Skonfiguruj projekt w chmurze: sprawdź, czy projekt Google Cloud został utworzony i czy interfejs Routes API jest w nim włączony.
- Routing dla dużych pojazdów: routing dla dużych pojazdów jest dostępny dla ograniczonej liczby klientów. Skontaktuj się z nami, aby poprosić o dostęp i skonfigurować projekt pod kątem tej funkcji.
- Utwórz żądanie: wywołaj punkt końcowy
computeRouteslubcomputeRouteMatrix, ustawiając parametrtravelModenaTRUCK, parametrroutingPreferencenaTRAFFIC_AWARE_OPTIMALi określając atrybuty pojazdu za pomocą obiektuvehicleInfo. - Zapewnij szczegółowe wskazówki dojazdu (opcjonalnie): jeśli wywołasz funkcję
computeRoutes, przekaż wartość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 z uwzględnieniem tras dla ciężarówek w pakiecie Navigation SDK na Android lub iOS.