Vai al contenuto principale

Sviluppatori

Dashboard
Dashboard
Rest

Filtri

I filtri permettono alle applicazioni di restringere le stazioni di ricarica restituite dall’API del servizio Tile. Oltre a nascondere i risultati non corrispondenti, alcuni filtri trasformano anche i dati delle stazioni per garantire che la risposta sia pertinente al contesto.

Come i filtri influenzano i dati

Quando una richiesta include dei filtri, il servizio Tile esegue due operazioni distinte:

  1. Esclusione delle stazioni non corrispondentiQualsiasi stazione che non soddisfa i criteri di filtro specificati viene rimossa del tutto dalla risposta. Questa operazione avviene quando vengono usati filtri a livello di stazione o a livello di EVSE.
  2. Trasformazione dei datiQuando vengono forniti determinati parametri di filtro, il servizio Tile ricalcola alcune proprietà dinamiche della stazione. Questa operazione avviene quando vengono usati filtri a livello di EVSE.

Implementazione

I parametri di filtro possono essere aggiunti all’URL della richiesta come stringhe di query a qualsiasi endpoint del servizio Tile (MVT, JSON o Conteggio). Se non viene applicato alcun filtro, vengono restituite tutte le stazioni di ricarica disponibili e non viene eseguita alcuna trasformazione dei dati.

Tile / Filter / Example
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?{filter_1}&{filter_2}&{filter_n}

Livelli

I filtri possono esistere su due livelli: a livello di EVSE o a livello di stazione, ciascuno con il proprio impatto e i propri risultati come descritto di seguito.

Livello stazione

Filtri che valutano gli attributi globali della stazione. Questi filtri sono solo di esclusione: escludono le stazioni non corrispondenti ma non modificano mai i campi di dati restituiti.

amenities · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?amenities[]=HOTEL
Filtra per includere solo le stazioni che offrono i servizi specificati.

Valori possibili

HOTELSHOPPINGBATHROOMSUPERMARKETPLAYGROUNDPHARMACYMUSEUMCOFFEEPARKRESTAURANT
preferred_operators · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?preferred_operators=true
Filtra per includere solo le stazioni gestite da operatori configurati come preferiti. Gli operatori preferiti possono essere impostati nelle impostazioni del progetto nel dashboard.

Valori possibili

truefalse
hide_excluded_operators · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?hide_excluded_operators=true
Filtra per escludere le stazioni gestite da operatori configurati come esclusi. Gli operatori esclusi possono essere impostati nelle impostazioni del progetto nel dashboard.

Valori possibili

truefalse
operator_ids · string · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052
Filtra per includere solo le stazioni gestite da specifici ID operatore. Accetta un array di ID operatore.
truck_dedicated · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?truck_dedicated=true
Filtra per includere solo le stazioni dedicate o destinate principalmente alla ricarica di camion. Applicabile solo se viene utilizzato il database di stazioni Eco-Movement; in caso contrario viene ignorato.

Valori possibili

truefalse
vehicle_types · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?vehicle_types[]=VAN&vehicle_types[]=RIGID
Filtra per includere solo le stazioni che supportano i tipi di veicolo OCPI specificati. Per impostazione predefinita sono inclusi tutti i tipi di veicolo. Applicabile solo se viene utilizzato il database di stazioni Eco-Movement; in caso contrario viene ignorato.

Valori possibili

VANRIGIDTRUCK_WITH_TRAILER

Livello EVSE

Filtri che valutano le specifiche capacità di ricarica della stazione. Questi filtri eseguono esclusione e trasformazione: le stazioni non corrispondenti vengono escluse e per quelle corrispondenti i campi dinamici vengono ricalcolati.

minimum_power · integer · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50
Filtra per includere solo le stazioni in cui almeno un connettore raggiunge o supera il valore di potenza specificato (in kW). Accetta un numero intero maggiore di 0.
maximum_power · integer · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150
Filtra per includere solo le stazioni in cui la potenza di ricarica massima di nessun connettore supera il valore di potenza specificato (in kW). Accetta un numero intero maggiore di 0.
minimum_energy_price · number · Beta Questo filtro è in beta e potrebbe cambiare prima di diventare stabile. · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_energy_price=0.2&currency=EUR
Filtra per includere solo le stazioni i cui connettori compatibili hanno almeno un prezzo attivo maggiore o uguale al valore specificato, valutato nella valuta impostata da currency. Vedi tariffe delle stazioni.
maximum_energy_price · number · Beta Questo filtro è in beta e potrebbe cambiare prima di diventare stabile. · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=EUR
Filtra per includere solo le stazioni i cui connettori compatibili hanno almeno un prezzo attivo minore o uguale al valore specificato, valutato nella valuta impostata da currency. Vedi tariffe delle stazioni.
connectors · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CHADEMO
Filtra per includere solo le stazioni che hanno EVSE con i tipi di connettore specificati. Accetta un array di stringhe con qualsiasi valore di connettore OCPI 2.2.1.

Valori possibili

CHADEMODOMESTIC_ADOMESTIC_BDOMESTIC_CDOMESTIC_DDOMESTIC_EDOMESTIC_FDOMESTIC_GDOMESTIC_HDOMESTIC_IDOMESTIC_JDOMESTIC_KDOMESTIC_LDOMESTIC_MDOMESTIC_NDOMESTIC_OIEC_60309_2_single_16IEC_60309_2_three_16IEC_60309_2_three_32IEC_60309_2_three_64IEC_62196_T1IEC_62196_T1_COMBOIEC_62196_T2IEC_62196_T2_COMBOIEC_62196_T3AIEC_62196_T3CPANTOGRAPH_BOTTOM_UPPANTOGRAPH_TOP_DOWNTESLA_RTESLA_SGB_TCHAOJINEMA_5_20NEMA_6_30NEMA_6_50NEMA_10_30NEMA_10_50NEMA_14_30NEMA_14_50
evse_statuses · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING
Filtra per includere solo le stazioni con EVSE che hanno gli stati specificati.

Valori possibili

BLOCKEDPLANNEDAVAILABLECHARGINGUNKNOWNRESERVEDOUT_OF_ORDERINOPERATIVE

Conversione di valuta

Il parametro di query currency è supportato dall’endpoint del servizio Tile (tile.json, tile.mvt e count). Imposta la valuta dei prezzi dell’energia restituiti e usati per il filtraggio.

  • Quando currency è omesso, connector_minimum_energy_price e connector_maximum_energy_price vengono restituiti in EUR.
  • Quando currency è un codice valuta ISO 4217 valido, come USD, GBP, DKK o EUR:
    • I valori restituiti in connector_minimum_energy_price e connector_maximum_energy_price vengono convertiti dalla valuta di origine alla valuta richiesta lato server, utilizzando il tasso di conversione attivo.
    • I filtri minimum_energy_price e maximum_energy_price vengono valutati sui prezzi convertiti nella valuta richiesta, o in EUR se currency è omesso.
  • Quando la valuta originale coincide con la valuta richiesta, price_conversion_rate viene restituito come 1.0.
  • Quando currency non è un codice valuta ISO 4217 valido, il servizio Tile restituisce un errore con questi dettagli:
    • Stato: 400 Bad Request
    • Codice: TILE_INVALID_PARAMETER_VALUE
    • Messaggio: Invalid parameter 'currency': found string {invalid currency} but expected one of {supported currencies}.
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=USD

Esempi

Per mostrare il comportamento, di seguito sono forniti esempi di filtraggio e di trasformazione dei dati.

Esempi di filtri

I filtri possono esistere su due livelli: a livello di EVSE o a livello di stazione, ciascuno con il proprio impatto e i propri risultati come descritto di seguito.

Stesso tipo di filtro, valori diversi
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO
StazioneProprietàCorrisponde
A2x IEC_62196_T1_COMBO
1x CHAdeMO
1x TOILET
1x RESTAURANT		Motivo della corrispondenza Ha un caricatore CHAdeMO
B1x IEC_62196_T1_COMBO
1x IEC_62196_T2_COMBO
1x RESTAURANT		Titolo Il testo della descrizione
C2x IEC_62196_T2_COMBO
1x TOILET		Titolo Il testo della descrizione
Più tipi di filtro diversi
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=120&evse_statuses[]=AVAILABLE&connectors[]=IEC_62196_T1_COMBO
StazioneProprietàCorrisponde
A2x IEC_62196_T1_COMBO
1x CHAdeMO
1x TOILET
1x RESTAURANT		Titolo Il testo della descrizione
B1x IEC_62196_T1_COMBO
1x IEC_62196_T2_COMBO
1x RESTAURANT		Titolo Il testo della descrizione
C2x IEC_62196_T2_COMBO
1x TOILET		Titolo Il testo della descrizione

Esempi di trasformazione dei dati

Alcuni output vengono ricalcolati quando si applicano filtri a livello di EVSE. Questi campi vengono “trasformati” per ignorare i connettori che non corrispondono ai criteri di ricerca dell’utente. Questi campi di output “dinamici” sono connector_maximum_power, connector_minimum_energy_price, connector_maximum_energy_price e evse_status_*.

Stesso tipo di filtro, valori diversi La richiesta include un filtro per il connettore CHADEMO. La stazione è inclusa perché ha un connettore CHADEMO, ma i campi dinamici vengono trasformati per ignorare i caricatori Combo Type 1.

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO
Response
json
{  "id": "station_a",  // Static: Remains 150 kW (This represents the station maximum power across all connectors)  "station_maximum_power": 150,  // Dynamic: Adjusted to 100 kW (Max power of the CHADEMO connector)  "connector_maximum_power": 100,  // Dynamic: Counts the 1 CHADEMO chargers  "evse_status_out_of_order": 0,  // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evse_status_available": 1}

Filtri di prezzo La richiesta include un filtro maximum_energy_price, eventualmente combinato con altri filtri a livello EVSE. Un connettore corrisponde solo se soddisfa tutti i filtri contemporaneamente e i campi di prezzo dinamici vengono ricalcolati solo per i connettori corrispondenti.

Stazione A di base

  • EVSE 1: CCS • 150 kW • Disponibile • 0,65 €
  • EVSE 2: CCS • 50 kW • Disponibile • 0,35 €
  • EVSE 3: Tipo 2 • 22 kW • Disponibile • 0,25 €

Scenario 1: solo filtro di prezzo

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.40

Corrispondenza: Gli EVSE 2 e 3 sono idonei. L’EVSE 1 è escluso.

Response
json
{  "connector_maximum_power": 50,  "evse_status_available": 2,  // Dynamic: lowest price of the matching connectors, not of the entire station  "connector_minimum_energy_price": 0.25,  // Dynamic: highest price of the matching connectors, not of the entire station  "connector_maximum_energy_price": 0.35}

Scenario 2: solo filtro di connettore

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CCS

Corrispondenza: Gli EVSE 1 e 2 sono idonei.

Response
json
{  "connector_maximum_power": 150,  "evse_status_available": 2,  // Dynamic: lowest price of the CCS connectors  "connector_minimum_energy_price": 0.35,  // Dynamic: highest price of the CCS connectors  "connector_maximum_energy_price": 0.65}

Scenario 3: filtro di prezzo e di connettore

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CCS&maximum_energy_price=0.30

Corrispondenza:

  • Valuta connector == CCS AND price <= 0.30.
  • I connettori CCS (EVSE 1 e 2) costano 0,65 € e 0,35 €, quindi non rispettano il filtro di prezzo.
  • Il connettore Tipo 2 (EVSE 3) rispetta il prezzo, ma non il filtro di connettore.

Risultato: Stazione esclusa (0 EVSE corrispondenti).

Scenario 4: filtro di prezzo e di potenza

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=100&maximum_energy_price=0.40

Corrispondenza:

  • Valuta power >= 100 kW AND price <= 0.40 € sullo stesso EVSE.
  • Il connettore da 150 kW è troppo costoso (0,65 €).
  • I connettori più economici (da 0,25 € a 0,35 €) sono troppo lenti (50 kW o meno).

Risultato: Stazione esclusa (0 EVSE corrispondenti).

Questo contenuto ti è stato utile?

Crea

Sviluppatori

Aggiornamenti

Risorse

Legale

Contattaci

Chargetrip ©

Stato sconosciuto

Gestisci i cookie

In vigore dal: 20 marzo 2024 · Aggiornato il: 25 gennaio 2023

Utilizziamo i cookie per migliorare la tua esperienza su developers.chargetrip.com. Questa politica sui cookie fa parte dell’informativa sulla privacy e riguarda l’uso dei cookie tra il tuo dispositivo e il nostro sito. Forniamo inoltre informazioni di base sui servizi di terze parti che potremmo utilizzare, i quali possono a loro volta usare cookie come parte del loro servizio, anche se non sono coperti dalla nostra politica.

Se non desideri accettare alcun cookie da parte nostra, devi impostare il tuo browser in modo da rifiutare i cookie provenienti da developers.chargetrip.com, tenendo presente che potremmo non essere in grado di offrirti alcuni dei contenuti e dei servizi desiderati.

Un cookie è un piccolo frammento di dati che un sito web memorizza sul tuo dispositivo quando lo visiti. In genere contiene informazioni sul sito stesso, un identificatore univoco che consente al sito di riconoscere il tuo browser quando torni, dati aggiuntivi che servono allo scopo del cookie e la durata del cookie stesso.

I cookie vengono utilizzati per abilitare determinate funzioni (ad es. l’accesso), per monitorare l’utilizzo del sito (ad es. analisi), per memorizzare le tue impostazioni utente (ad es. fuso orario, preferenze di notifica) e per personalizzare i tuoi contenuti (ad es. pubblicità, lingua).

I cookie impostati dal sito web che stai visitando sono normalmente chiamati “cookie di prima parte” e in genere tracciano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ovvero terze parti) possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti.

I cookie impostati dal sito web che stai visitando sono normalmente chiamati “cookie di prima parte” e in genere tracciano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ovvero terze parti) possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti.

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e i tuoi interessi. I siti web possono usarli per mostrare pubblicità mirata o per limitare il numero di volte in cui visualizzi un annuncio. Questo aiuta le aziende a migliorare l’efficacia delle loro campagne e la qualità dei contenuti che ti vengono presentati. Questi cookie possono essere impostati dal sito web che stai visitando (prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti. Utilizziamo cookie di targeting/pubblicitari sul nostro sito.

Cookie di marketing / pubblicitari

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e i tuoi interessi. I siti web possono usarli per mostrare pubblicità mirata o per limitare il numero di volte in cui visualizzi un annuncio. Questo aiuta le aziende a migliorare l’efficacia delle loro campagne e la qualità dei contenuti che ti vengono presentati. Questi cookie possono essere impostati dal sito web che stai visitando (prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per tracciarti su altri siti web che utilizzano lo stesso servizio di terze parti. Utilizziamo cookie di targeting/pubblicitari sul nostro sito.

Impegno verso le terze parti

Esaminiamo le informative sulla privacy di tutti i nostri fornitori terzi prima di avvalerci dei loro servizi, per assicurarci che le loro pratiche siano in linea con le nostre. Non includeremo mai consapevolmente servizi di terze parti che compromettano o violino la privacy dei nostri utenti.

Cookie
google-cookie-consent
Descrizione
Memorizza le tue preferenze sui cookie, ovvero quali categorie hai accettato o rifiutato, in modo da rispettare la tua scelta a ogni visita e caricare solo gli strumenti di analisi o di marketing che hai autorizzato.
Durata
2 anni

Se non desideri accettare i cookie da parte nostra, puoi impostare il tuo browser in modo da rifiutare i cookie del nostro sito web. La maggior parte dei browser è configurata per accettare i cookie per impostazione predefinita, ma puoi modificare queste impostazioni per rifiutare del tutto i cookie oppure per ricevere una notifica quando un sito web tenta di impostarne uno.

Se navighi su siti web da più dispositivi, potresti dover aggiornare le impostazioni su ciascun dispositivo.

Anche se alcuni cookie possono essere bloccati con un impatto minimo sull’esperienza di un sito web, bloccare tutti i cookie potrebbe impedirti di accedere ad alcune funzioni e contenuti dei siti che visiti.

Potremmo aggiornare questa Politica sui cookie di tanto in tanto, ad esempio per riflettere modifiche ai cookie che utilizziamo o per altri motivi operativi, legali o normativi. Ti invitiamo a rivisitare questa Politica sui cookie per rimanere informato sul nostro uso dei cookie e delle tecnologie correlate. La data in alto in questa Politica sui cookie indica quando è stata aggiornata l’ultima volta.