La funzionalità di routing per veicoli di grandi dimensioni dell'API Routes calcola i percorsi e gli orari di arrivo stimati per i veicoli di grandi dimensioni. Restituisce percorsi ottimizzati che evitano le limitazioni in base all'altezza, al peso, alla lunghezza e alle classificazioni dei materiali pericolosi del veicolo. Il servizio genera anche un token di percorso che può essere passato all'SDK Navigation per fornire indicazioni passo passo.
Perché utilizzare il routing per veicoli di grandi dimensioni
Utilizza il routing per veicoli di grandi dimensioni per creare applicazioni che risolvano le sfide logistiche per le flotte di veicoli di grandi dimensioni.
| Vantaggi | Descrizione |
|---|---|
| Migliora l'accuratezza dei prezzi e della pianificazione | Genera orari di arrivo stimati specifici e basati sul traffico che consentono di ottenere preventivi e finestre di consegna più precisi per veicoli di grandi dimensioni come camion e autobus. |
| Migliora la sicurezza e l'efficienza dei conducenti | Guida i conducenti lungo i percorsi che evitano ponti bassi, strade con limitazioni di peso e altri pericoli. |
| Semplifica le operazioni a livello di flotta | Utilizza Route Optimization insieme al routing per veicoli di grandi dimensioni per ottimizzare le assegnazioni di carico e l'ordinamento delle fermate per un intero parco risorse. Utilizza Fleet Engine per consentire la visibilità in tempo reale delle assegnazioni e delle posizioni dei veicoli. |
| Riduci al minimo la formazione e aumenta l'adozione | Offri ai conducenti di veicoli di grandi dimensioni o camion la familiarità della navigazione in Google Maps all'interno della tua applicazione. |
Cosa puoi fare con il routing per veicoli di grandi dimensioni
Con il routing per veicoli di grandi dimensioni, puoi eseguire le seguenti operazioni chiave:
- Specifica le proprietà dettagliate del veicolo, tra cui altezza, peso, lunghezza, larghezza, numero di assi e classificazioni delle merci pericolose.
- Ottieni un percorso, un tempo di percorrenza e una distanza di percorrenza calcolati appositamente per gli attributi del veicolo.
- Genera percorsi ottimizzati per la manovrabilità evitando automaticamente le inversioni a U e preferendo fortemente le autostrade. In questo modo, i veicoli di grandi dimensioni rimangono su percorsi che soddisfano le esigenze e le aspettative dei conducenti.
- Calcola un orario di arrivo stimato più preciso utilizzando un modello di orario di arrivo stimato specifico per i camion. Il modello combina le velocità di percorrenza dei camion osservate con i dati sul traffico in tempo reale e predittivi per fornire stime più accurate per i veicoli di grandi dimensioni.
- Attiva la navigazione passo passo nell'SDK Navigation utilizzando un token di percorso per trasferire un percorso sicuro per i camion dall'API Routes.
- Calcola le matrici di percorso per determinare i tempi di percorrenza e le distanze tra più origini e destinazioni per la pianificazione a livello di flotta.
- Ottimizza il piano di percorso per il parco risorse di camion per l'efficienza operativa complessiva che tenga conto della fattibilità e della sicurezza.
Come funziona il routing per veicoli di grandi dimensioni
La funzionalità di routing per veicoli di grandi dimensioni funziona tramite i seguenti servizi:
| Endpoint | Operazione | Output |
|---|---|---|
| API Routes | Una richiesta HTTPS a un endpoint dell'API Routes (computeRoutes o computeRouteMatrix) con un corpo della richiesta che include l'origine e la destinazione. travelMode deve essere impostato su TRUCK e l'oggetto routeModifiers deve includere vehicleInfo.
|
Una polilinea del percorso, un elenco di segmenti e passaggi del percorso, un tempo di percorrenza stimato e un token di percorso. |
| API Route Optimization | Una richiesta HTTPS all'endpoint dell'API Route Optimization. travelMode deve essere impostato su TRUCK e l'oggetto routeModifiers deve includere vehicleInfo.
|
Un piano di percorso ottimizzato per la flotta progettato per il veicolo specifico e token di percorso per ogni viaggio. |
| SDK Navigation (Android, iOS) | Includi un token di percorso (generato dall'API Routes o dall'API Route Optimization con il routing per veicoli di grandi dimensioni) quando imposti le destinazioni nel navigatore. | Esperienza di navigazione passo passo personalizzata per i camion e che segue un percorso conforme alle informazioni sul veicolo specificate nella richiesta API originale dell'API Routes o dell'API Route Optimization. |
Esempio
Il seguente esempio si concentra sull'utilizzo del routing per veicoli di grandi dimensioni con l'API Routes.
Ad esempio, un corpo della richiesta computeRoutes di base ha il seguente aspetto:
{
"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
}
}
}
Obbligatorio: la richiesta deve impostare travelMode su TRUCK e compilare l'
vehicleInfo oggetto con le dimensioni e gli attributi specifici del veicolo.
L'API Routes restituisce un percorso che tiene conto delle informazioni sul veicolo specificate. A seconda della maschera di campo specificata, la risposta può includere la polilinea del percorso, un orario di arrivo stimato specifico per i camion, la distanza di percorrenza e un token di percorso da utilizzare con l'SDK Navigation. La risposta indica anche se non è possibile trovare un percorso completamente conforme.
Contenuti di richiesta e risposta
La seguente tabella elenca i dati che invii e ricevi quando effettui una richiesta di routing per veicoli di grandi dimensioni utilizzando il metodo computeRoutes dell'API Routes.
| Contenuti della richiesta | Contenuti della risposta | Formato di restituzione |
|---|---|---|
|
|
JSON |
Limitazioni
Prima di iniziare, devi conoscere le seguenti limitazioni e i seguenti requisiti.
- Disponibilità geografica: il routing per veicoli di grandi dimensioni è disponibile nei 48 stati contigui degli Stati Uniti (disponibilità generale) e Giappone (sperimentale). Non è disponibile in Alaska, Hawaii o nei territori degli Stati Uniti.
- Avvisi e sicurezza per i conducenti. I conducenti non devono fare affidamento esclusivamente sui percorsi restituiti da questa API per essere sicuri o legali. Non è garantito che i percorsi siano adatti al veicolo e, se li seguono, i conducenti potrebbero essere esposti a pericoli come ponti bassi o strade in cui i veicoli di grandi dimensioni sono vietati.
- Percorsi con il criterio del "best effort". In alcuni casi, l'API non riesce a trovare un percorso completamente conforme alle limitazioni di viaggio. Restituisce invece un percorso con il criterio del "best effort" che potrebbe comunque attraversare aree con limitazioni. La risposta dell'API Routes contrassegna chiaramente questi percorsi nel campo
routeRestrictionsPartiallyIgnored. In questi casi, pianifica attentamente il percorso, idealmente utilizzando altri dati di origine. Non utilizzare un percorso contrassegnato come unica fonte attendibile per la pianificazione o la navigazione. - Funzionalità non supportate: il routing per veicoli di grandi dimensioni non supporta le
seguenti funzionalità:
- Prezzi dei pedaggi per i camion
- Limiti di velocità
- Routing per materiali pericolosi radioattivi
- Limiti di utilizzo: tutte le richieste sono soggette ai limiti standard di query al secondo (QPS).
Come utilizzare il routing per veicoli di grandi dimensioni
Per utilizzare il routing per veicoli di grandi dimensioni con l'API Routes:
- Configura il progetto:assicurati che il progetto Google Cloud sia stato creato e abilitato per l'API Routes.
- Provisioning per il routing per veicoli di grandi dimensioni: il routing per veicoli di grandi dimensioni è disponibile per un numero limitato di clienti. Contattaci per richiedere l'accesso e ottenere il provisioning del progetto per questa funzionalità.
- Crea una richiesta:chiama l'endpoint
computeRoutesocomputeRouteMatrixcontravelModeimpostato suTRUCK, impostaroutingPreferencesuTRAFFIC_AWARE_OPTIMALe specifica gli attributi del veicolo utilizzando l'oggettovehicleInfo. - Fornisci la navigazione passo passo (facoltativo) : se hai chiamato
computeRoutes, passa ilrouteTokendalla risposta all'SDK Navigation per avviare una sessione di navigazione.
Passaggi successivi
- Inizia: Genera percorsi e orari di arrivo stimati per i camion con l'API Routes
- Aggiungi la navigazione: fornisci la navigazione passo passo con percorsi specifici per i camion nell'SDK Navigation per Android o iOS