Selettori
Per ottimizzare la latenza di rete e le prestazioni di rendering, i servizi di tile MVT e JSON di Chargetrip restituiscono per impostazione predefinita un payload minimo. Questo payload predefinito fornisce la geometria essenziale e i dati di clustering necessari per renderizzare rapidamente i tile della mappa.
Utilizzando i selettori, puoi richiedere gli specifici attributi dei dati delle stazioni di cui la tua applicazione client ha bisogno, senza un sovraccarico inutile del payload.
Implementazione
Per richiedere attributi specifici delle stazioni, aggiungi il parametro di query station_properties[] all’URL della richiesta del tile. Ripeti il parametro per ogni selettore che vuoi includere:
Selettori disponibili
I selettori si applicano solo alle feature di stazione; le feature di cluster non sono interessate e restituiscono sempre count e expansion_zoom.
count·integer· default- Il numero di stazioni all’interno di un cluster. Un conteggio pari a 1 indica una feature di stazione, mentre un conteggio maggiore di 1 indica una feature di cluster.
id·string· default- L’identificativo Chargetrip univoco della stazione. Applicabile solo ai tile MVT.
lng·float- La longitudine della stazione. Applicabile solo ai tile MVT.
lat·float- La latitudine della stazione. Applicabile solo ai tile MVT.
operator_id·string- L’identificativo Chargetrip univoco dell’operatore della stazione. Non restituito se l’operatore è sconosciuto.
station_maximum_power·integer- La potenza di ricarica massima (in kW) disponibile presso la stazione. Questo valore è statico e riflette sempre la massima capacità della stazione, indipendentemente dai filtri sui connettori.
connector_maximum_power·integer- La potenza di ricarica massima (in kW) disponibile dai connettori corrispondenti al filtro
connectors[]. Se non viene fornito alcun filtro, vengono considerati tutti i connettori e il valore coincide constation_maximum_power. preferred_operator·boolean- Indica se il gestore di una stazione è un gestore preferito. Le preferenze sui gestori possono essere gestite nella dashboard di Chargetrip.
connector_minimum_energy_price·float·Beta Questo campo è in beta e potrebbe cambiare prima di diventare stabile. - Il prezzo dell’energia più basso tra i connettori della stazione. Non restituito se non disponibile.
connector_maximum_energy_price·float·Beta Questo campo è in beta e potrebbe cambiare prima di diventare stabile. - Il prezzo dell’energia più alto tra i connettori della stazione. Non restituito se non disponibile.
price_vat·float·Beta Questo campo è in beta e potrebbe cambiare prima di diventare stabile. - L’IVA applicata al prezzo. Non restituita se non disponibile.
price_valid_until·string·Beta Questo campo è in beta e potrebbe cambiare prima di diventare stabile. - La data e l’ora fino alle quali il prezzo è valido. Non restituita se non disponibile.
price_original_currency·string·Beta Questo campo è in beta e potrebbe cambiare prima di diventare stabile. - La valuta in cui il prezzo era originariamente definito, prima della conversione in
currency. Non restituita se non disponibile. price_conversion_rate·float·Beta Questo campo è in beta e potrebbe cambiare prima di diventare stabile. - Il tasso utilizzato per convertire il prezzo dalla valuta originale a
currency. Non restituito se non disponibile. evses_blocked·integer- Numero di EVSE bloccati fisicamente o elettronicamente. Se viene fornito un filtro
connectors[], conta solo gli EVSE bloccati che hanno almeno uno dei tipi di connettore selezionati. evses_planned·integer- Numero di EVSE con stato pianificato. Se viene fornito un filtro
connectors[], conta solo gli EVSE pianificati che hanno almeno uno dei tipi di connettore selezionati. evses_available·integer- Numero di EVSE con stato disponibile. Se viene fornito un filtro
connectors[], conta solo gli EVSE disponibili che hanno almeno uno dei tipi di connettore selezionati. evses_charging·integer- Numero di EVSE attualmente occupati. Se viene fornito un filtro
connectors[], conta solo gli EVSE in ricarica che hanno almeno uno dei tipi di connettore selezionati. evses_unknown·integer- Numero di EVSE il cui stato in tempo reale è attualmente sconosciuto. Se viene fornito un filtro
connectors[], conta solo gli EVSE con stato sconosciuto che hanno almeno uno dei tipi di connettore selezionati. evses_reserved·integer- Numero di EVSE riservati a un conducente. Se viene fornito un filtro
connectors[], conta solo gli EVSE riservati che hanno almeno uno dei tipi di connettore selezionati. evses_out_of_order·integer- Numero di EVSE contrassegnati come fuori servizio. Se viene fornito un filtro
connectors[], conta solo gli EVSE fuori servizio che hanno almeno uno dei tipi di connettore selezionati. evses_inoperative·integer- Numero di EVSE temporaneamente non operativi. Se viene fornito un filtro
connectors[], conta solo gli EVSE non operativi che hanno almeno uno dei tipi di connettore selezionati.
Esempi
Richiedere la potenza della stazione e la preferenza del gestore nei tile JSON
Nei tile JSON, la struttura obbligatoria della feature (type, geometry, id) viene sempre mantenuta sulle feature di stazione, mentre properties contiene solo i selettori richiesti (la proprietà predefinita count viene omessa perché non è stata richiesta). Le feature di cluster non sono interessate dai selettori e restituiscono comunque count e expansion_zoom.
Richiedere ID della stazione, potenza e preferenza del gestore nei vector tile MVT
Nei tile MVT, solo i selettori richiesti esplicitamente vengono codificati nella feature di stazione (omettendo la proprietà predefinita count), mentre le feature di cluster non sono interessate dai selettori e mantengono sempre count e expansion_zoom.
Combinare i selettori con i filtri sui connettori per lo stato EVSE in tempo reale
Quando si filtra per uno specifico tipo di connettore (ad esempio CCS / IEC_62196_T2_COMBO), i conteggi connector_maximum_power ed evses_available riflettono solo gli EVSE che corrispondono a quel filtro sui connettori.
Questo contenuto ti è stato utile?