Guida

Percorso

La pianificazione dei percorsi per gli EV presenta sfide uniche. La capacità della batteria, il consumo energetico reale, la topografia, il meteo e la disponibilità della rete di ricarica determinano se un veicolo raggiungerà la destinazione.

La Route API considera tutte queste variabili per trovare percorsi EV ottimali. Grazie a un modello di consumo energetico di livello mondiale, inserisce automaticamente le tappe di ricarica esattamente quando e dove servono. I percorsi sono completamente personalizzabili, così puoi perfezionarli per adattarli alle tue regole di business.

Come funziona

Per garantire prestazioni elevate, la Route API opera in modo asincrono, seguendo lo stesso pattern asincrono utilizzato in tutta l’API. La creazione e il recupero di un percorso avvengono in passaggi separati.

Crea un percorsoChiama la mutation createRoute con almeno un vehicle, un origin e una destination. La mutation restituisce subito l’id del percorso, che userai nel passaggio successivo per monitorare e recuperare il percorso. Sono disponibili molte altre opzioni di personalizzazione; vedi personalizza il tuo percorso più sotto.
Apri una subscriptionSottoscrivi la subscription route usando l’id del passaggio precedente. Mentre il percorso viene calcolato, la subscription invia aggiornamenti di stato che puoi usare per gestire uno stato di caricamento asincrono nella tua interfaccia.
Mostra il risultatoQuando lo status del percorso diventa done, error o not_found, mostra l’interfaccia corrispondente a quell’esito.
Recupera di nuovo su richiestaUn percorso che ha raggiunto uno stato finale positivo viene memorizzato con tutti i suoi dettagli. Se devi mostrarlo di nuovo in seguito, ad esempio dopo esserci tornato con la navigazione, usa la query getRoute invece di aprire una nuova subscription.

I veicoli ibridi e ibridi plug-in non si affidano esclusivamente alla batteria, quindi i loro percorsi non includono tappe di ricarica.

Personalizza il tuo percorso

createRoute accetta una serie di input opzionali per perfezionare il modo in cui viene calcolato un percorso. Maggiori dettagli su ciascun campo sono disponibili nel riferimento API.

Funzionalità	Descrizione
Punti di passaggio	Aggiungi tappe intermedie. Fornisci `via.properties.station.station_id` per forzare una tappa di ricarica in una stazione specifica, oppure solo `via.geometry` per un semplice punto di transito senza ricarica.
Durata della tappa	Imposta per quanto tempo, in secondi, il veicolo resta in un punto di passaggio o a destinazione, usando `properties.station.stop_duration` o `properties.location.stop_duration`.
Ricarica in autostrada	Dai priorità alle stazioni di ricarica situate direttamente sull’autostrada con `station_preferences.prefer_highway_charging`, evitando soste che richiedono di uscire dall’autostrada.
Meteo	Applica un preset meteo o condizioni meteo personalizzate al modello di consumo. Per impostazione predefinita usa i dati meteo in tempo reale.
Stagione	Presuppone condizioni meteo `summer`, `winter` o `current`, come alternativa più semplice a `weather`.
Elementi del percorso da evitare	Evita `toll_road` o `ferry` secondo il principio del massimo impegno.
Classifica degli operatori	Preferisci reti di ricarica specifiche con `type: preferred`, oppure limita il percorso solo a quelle reti con `type: required`. Classifica gli operatori come `high`, `medium` o `low` e limita la classifica a paesi specifici per ciascun operatore.
Esclusione di operatori	Escludi completamente un operatore dal percorso con `operators.exclude`. Se non è impostato a livello di richiesta, usa la configurazione della dashboard del tuo progetto.
Elusione di operatori	Evita un operatore senza escluderlo del tutto, usando `operators.avoid`.
Stazioni di ricarica alternative	Cerca stazioni di ricarica alternative entro un raggio compreso tra 500 e 5000 metri lungo il percorso.
Percorsi alternativi	Richiedi opzioni di percorso aggiuntive, secondo il principio del massimo impegno. Imposta `0` per calcolare solo il percorso consigliato.
Preferenze di guida	Regola lo stile di guida con `speed_factor` o `maximum_speed`, oppure scegli uno `style` tra `eco` e `sport`.
Consapevolezza del traffico	Tieni conto della congestione del traffico in tempo reale. Contatta il supporto per abilitarla nel tuo progetto.
Orario di partenza	Calcola gli orari di arrivo previsti usando il traffico in tempo reale e il meteo storico, attuale o previsto.
Destinazione come stazione	Imposta una stazione specifica come destinazione del percorso. Viene trattata come una tappa senza ricarica.
Carico del veicolo per punto di passaggio	Imposta `occupants`, `total_occupant_weight` e `total_cargo_weight` su `origin` o `via`. Questi valori si propagano per il resto del viaggio e possono essere sovrascritti in qualsiasi punto via successivo.
Potenza di ricarica minima	Per impostazione predefinita, il calcolo del percorso esclude i connettori sotto i 43 kW. Imposta un minimo diverso per adattarlo alla velocità di ricarica del tuo veicolo. I caricatori con potenza nominale superiore vengono comunque selezionati anche se il tuo veicolo si ricarica più lentamente della loro velocità massima.

Questo contenuto ti è stato utile?