Visualizza autonomia veicolo

Un’isolina mostra l’area che un EV può raggiungere da un determinato punto con l’energia che ha a bordo. Risponde a una domanda semplice, fin dove può arrivare questo veicolo da qui, e disegna la risposta come forme che puoi posizionare su una mappa.

Gli usi tipici sono una mappa dell’autonomia attorno a una città, un controllo del tipo “ci arrivo senza ricaricare?” o un filtro che mostra solo le stazioni che un veicolo può effettivamente raggiungere.

Un’isolina usa la rete stradale reale come riferimento. Il calcolo individua i punti più lontani che il veicolo può raggiungere su strada e il contorno collega questi punti tra loro. Il risultato è un’area piena, non una linea che segue le strade, quindi i tratti tra una strada e l’altra, come boschi o campi, possono rientrarvi. Fiumi, montagne, sistemi a senso unico e lacune nella rete influenzano comunque il contorno, perché stabiliscono fin dove le strade permettono al veicolo di arrivare.

Come funziona

Come i percorsi, le isoline vengono calcolate in modo asincrono, seguendo lo stesso pattern asincrono utilizzato in tutta l’API. La creazione e il recupero di un’isolina avvengono in passaggi separati.

1. Crea un’isolinaChiama la mutation createIsoline con almeno un vehicle_id e un origin. La mutation restituisce subito l’id dell’isolina, che userai nel passaggio successivo. Gli input opzionali, come il livello della batteria o il meteo, sono trattati in personalizza la tua isolina.
2. Apri una subscriptionSottoscrivi la subscription isoline usando l’id del passaggio precedente. Mentre l’isolina viene calcolata, lo stato è pending. Usalo per gestire uno stato di caricamento nella tua interfaccia.
3. Mostra il risultatoQuando lo status diventa done o error, mostra l’interfaccia corrispondente. Un’isolina done contiene i polygons da disegnare sulla mappa.
4. Recupera di nuovo su richiestaUn’isolina completata viene memorizzata con tutti i suoi dettagli. Per mostrarla di nuovo in seguito, usa la query isoline con lo stesso id invece di aprire una nuova subscription.

Poligoni

Il risultato è un elenco di poligoni. Insieme descrivono l’area raggiungibile per gradi, dalla vicinanza all’origine fino al punto più lontano che il veicolo può raggiungere guidando.

Usa polygon_count per scegliere quanti poligoni ottenere, fino a un massimo di 20.

• Meno poligoni ti offrono un quadro semplice e approssimativo dell’autonomia del veicolo. Sono più rapidi da disegnare e più facili da leggere a colpo d’occhio.
• Più poligoni ti offrono passaggi più fini tra l’origine e l’autonomia massima, utili per un gradiente o per una mappa dell’autonomia più dettagliata.

Ogni poligono ha un index nelle sue properties per distinguerli e maximum_distance indica la distanza dall’origine al punto più lontano raggiungibile.

Crea la tua prima isolina

Bastano un vehicle_id e un origin per creare un’isolina. Questo esempio imposta anche il livello della batteria, il numero di poligoni e il meteo, così puoi vedere come si combinano le opzioni principali.

mutation CreateIsoline {  createIsoline(    input: {      vehicle_id: "607823b2c246f9001b97b1a2"      origin: {        type: Feature        geometry: { type: Point, coordinates: [4.895168, 52.370216] }      }      state_of_charge: { value: 80, type: percentage }      polygon_count: 5      weather: { type: winter }    }  )}

La mutation restituisce l’id dell’isolina. Passalo alla subscription isoline per seguire il calcolo e ricevere il risultato:

subscription Isoline {  isoline(id: "65f1a2b3c4d5e6f7a8b9c0d1") {    id    status    maximum_distance    polygons {      properties {        index      }      geometry {        type        coordinates      }    }  }}

In questa richiesta:

• state_of_charge fa partire il veicolo con la batteria all’80%. Senza questo parametro, l’isolina usa l’intera capacità utilizzabile della batteria del veicolo.
• polygon_count restituisce cinque poligoni, dalla vicinanza all’origine fino all’autonomia massima.
• weather usa il preset winter, che presuppone condizioni di freddo e in genere produce un’area raggiungibile più piccola rispetto al valore predefinito del meteo in tempo reale.

Personalizza la tua isolina

createIsoline accetta una serie di input opzionali per perfezionare il calcolo. Maggiori dettagli su ciascun campo sono disponibili nel riferimento API.