La funzionalità di routing per veicoli di grandi dimensioni dell'API Routes calcola i percorsi e gli orari di arrivo stimati (ETA) 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 stradali passo passo.
Perché utilizzare il percorso per veicoli di grandi dimensioni
Utilizza il routing di veicoli di grandi dimensioni per creare applicazioni che risolvono 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 fornire preventivi e finestre di consegna più accurati per veicoli di grandi dimensioni come camion e autobus. |
| Migliora la sicurezza e l'efficienza dei conducenti | Guida i conducenti lungo percorsi che evitano ponti bassi, strade con limiti di peso e altri pericoli. |
| Semplifica le operazioni a livello di parco risorse | Utilizza Route Optimization insieme al routing per veicoli di grandi dimensioni per ottimizzare le assegnazioni dei carichi e l'ordine delle fermate per un'intera flotta. 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à dell'esperienza di 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 viaggio calcolati specificamente per gli attributi del veicolo.
- Genera percorsi ottimizzati per la manovrabilità evitando automaticamente le inversioni a U e preferendo nettamente le autostrade. In questo modo, i veicoli di grandi dimensioni rimangono su percorsi che soddisfano le esigenze e le aspettative dei loro conducenti.
- Calcola un'ora di arrivo stimata più accurata utilizzando un modello di ora di arrivo stimata 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 dei percorsi per determinare i tempi di percorrenza e le distanze tra più origini e destinazioni per la pianificazione dell'intera flotta.
- Ottimizza il piano di percorso per il tuo parco di camion per l'efficienza operativa complessiva che tiene conto della fattibilità e della sicurezza.
Come funziona il calcolo di percorsi 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 tappe e passaggi del percorso, il tempo di percorrenza stimato e un token del 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 il parco veicoli progettato per il veicolo specifico e i token di percorso per ogni corsa. |
| Navigation SDK (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
L'esempio seguente 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'oggetto vehicleInfo con le dimensioni e gli attributi specifici del veicolo.
L'API Routes restituisce un percorso che tiene conto delle informazioni sul veicolo specificate. La risposta può includere la polilinea del percorso, un'ora di arrivo stimata specifica per i camion, la distanza di viaggio e un token del percorso da utilizzare con l'SDK Navigation, a seconda della maschera di campo specificata. La risposta indica anche se non è possibile trovare un percorso completamente conforme.
Contenuti di richiesta e risposta
La tabella seguente 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 delle richieste | Contenuti della risposta | Formato di ritorno |
|---|---|---|
|
|
JSON |
Limitazioni
Prima di iniziare, devi essere a conoscenza delle seguenti limitazioni e dei seguenti requisiti.
- Disponibilità geografica: il routing per veicoli di grandi dimensioni è disponibile nei 48 Stati Uniti contigui (disponibilità generale) e in Giappone (sperimentale). Non è disponibile in Alaska, alle 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 garantire la sicurezza o la legalità. Non è garantito che i percorsi siano adatti al veicolo e seguirli potrebbe esporre i conducenti a pericoli come ponti bassi o strade in cui è vietato il transito di veicoli di grandi dimensioni.
- Route best-effort. In alcuni casi, l'API non riesce a trovare un percorso che
rispetti completamente le limitazioni di viaggio. Restituisce invece un percorso "best effort" che potrebbe comunque attraversare aree soggette a restrizioni. La risposta dell'API Routes segnala chiaramente questi percorsi nel campo
routeRestrictionsPartiallyIgnored. In questi casi, pianifica attentamente il percorso, idealmente utilizzando altre origini dati. Non utilizzare un percorso segnalato come unica fonte attendibile per la pianificazione o la navigazione. - Funzionalità non supportate: il routing per veicoli di grandi dimensioni non supporta quanto segue:
- Prezzi dei pedaggi per i camion
- Limiti di velocità
- Percorso per materiali pericolosi radioattivi
- Limiti di utilizzo: tutte le richieste sono soggette ai limiti di query al secondo (QPS) standard.
Come utilizzare il percorso per veicoli di grandi dimensioni
Per utilizzare il routing per veicoli di grandi dimensioni con l'API Routes, segui questi passaggi:
- Configura il progetto: assicurati che il tuo progetto Google Cloud sia creato e abilitato per l'API Routes.
- Provisioning per il routing di veicoli di grandi dimensioni: il routing di veicoli di grandi dimensioni è disponibile per un gruppo limitato di clienti. Contattaci per richiedere l'accesso ed eseguire il provisioning del tuo 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 per camion e orari di arrivo stimati 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