Filtres

Les filtres permettent aux applications d’affiner les stations de recharge renvoyées par l’API du service de tuiles. Au-delà du simple masquage des résultats non correspondants, certains filtres transforment aussi les données des stations afin que la réponse reste pertinente selon le contexte.

Comment les filtres affectent les données

Lorsqu’une requête inclut des filtres, le service de tuiles effectue deux opérations distinctes :

1. Exclusion des stations non correspondantesToute station ne répondant pas aux critères de filtrage spécifiés est entièrement supprimée de la réponse. Cette opération a lieu lorsque des filtres au niveau de la station ou de l’EVSE sont utilisés.
2. Transformation des donnéesLorsque certains paramètres de filtrage sont fournis, le service de tuiles recalcule certaines propriétés dynamiques de la station. Cette opération a lieu lorsque des filtres au niveau de l’EVSE sont utilisés.

Implémentation

Les paramètres de filtre peuvent être ajoutés à l’URL de la requête sous forme de chaînes de requête pour n’importe quel endpoint du service de tuiles (MVT, JSON ou Count). Si aucun filtre n’est appliqué, toutes les stations de recharge disponibles sont renvoyées et aucune transformation de données n’est effectuée.

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

Niveaux

Les filtres peuvent exister à deux niveaux : au niveau de l’EVSE ou au niveau de la station, chacun avec son propre impact et ses propres résultats, comme décrit ci-dessous.

Niveau station

Filtres qui évaluent les attributs globaux de la station. Ces filtres servent uniquement à exclure : ils excluent les stations non correspondantes mais ne modifient jamais les champs de données renvoyés.

amenities · enum · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?amenities[]=HOTEL

Filtre pour inclure uniquement les stations qui proposent les équipements spécifiés.

Valeurs possibles

HOTELSHOPPINGBATHROOMSUPERMARKETPLAYGROUNDPHARMACYMUSEUMCOFFEEPARKRESTAURANT

preferred_operators · boolean · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?preferred_operators=true

Filtre pour inclure uniquement les stations exploitées par des opérateurs configurés comme préférés. Les opérateurs préférés peuvent être définis dans les paramètres du projet dans le dashboard.

Valeurs possibles

truefalse

hide_excluded_operators · boolean · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?hide_excluded_operators=true

Filtre pour exclure les stations exploitées par des opérateurs configurés comme exclus. Les opérateurs exclus peuvent être définis dans les paramètres du projet dans le dashboard.

Valeurs possibles

truefalse

operator_ids · string · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052

Filtre pour inclure uniquement les stations exploitées par des identifiants d’opérateur spécifiques. Accepte un tableau d’identifiants d’opérateur.

truck_dedicated · boolean · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?truck_dedicated=true

Filtre pour inclure uniquement les stations dédiées ou principalement destinées à la recharge de camions. Applicable uniquement si la base de données de stations Eco-Movement est utilisée ; sinon, il est ignoré.

Valeurs possibles

truefalse

vehicle_types · enum · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?vehicle_types[]=VAN&vehicle_types[]=RIGID

Filtre pour inclure uniquement les stations prenant en charge les types de véhicules OCPI spécifiés. Tous les types de véhicules sont inclus par défaut. Applicable uniquement si la base de données de stations Eco-Movement est utilisée ; sinon, il est ignoré.

Valeurs possibles

VANRIGIDTRUCK_WITH_TRAILER

Niveau EVSE

Filtres qui évaluent les capacités de charge spécifiques de la station. Ces filtres effectuent une exclusion et une transformation : les stations non correspondantes sont exclues, et les champs dynamiques des stations correspondantes sont recalculés.

minimum_power · integer · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50

Filtre pour inclure uniquement les stations dont au moins un connecteur atteint ou dépasse la puissance spécifiée (en kW). Accepte un entier supérieur à 0.

maximum_power · integer · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150

Filtre pour inclure uniquement les stations dont la puissance de charge maximale d’aucun connecteur ne dépasse la puissance spécifiée (en kW). Accepte un entier supérieur à 0.

minimum_energy_price · number · betaBêta Ce filtre est en bêta et peut changer avant de devenir stable. · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_energy_price=0.2&currency=EUR

Filtre pour inclure uniquement les stations dont les connecteurs compatibles ont au moins un prix actif supérieur ou égal à la valeur spécifiée, évalué dans la devise définie par currency. Voir tarification des stations.

maximum_energy_price · number · betaBêta Ce filtre est en bêta et peut changer avant de devenir stable. · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=EUR

Filtre pour inclure uniquement les stations dont les connecteurs compatibles ont au moins un prix actif inférieur ou égal à la valeur spécifiée, évalué dans la devise définie par currency. Voir tarification des stations.

connectors · enum · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CHADEMO

Filtre pour inclure uniquement les stations dont les EVSE ont les types de connecteurs spécifiés. Accepte un tableau de chaînes avec n’importe quelle valeur de connecteur OCPI 2.2.1.

Valeurs possibles

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 · Afficher l’URL d’exemplehttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING

Filtre pour inclure uniquement les stations dont les EVSE ont les statuts spécifiés.

Valeurs possibles

BLOCKEDPLANNEDAVAILABLECHARGINGUNKNOWNRESERVEDOUT_OF_ORDERINOPERATIVE

Conversion de devise

Le paramètre de requête currency est pris en charge par l’endpoint du service de tuiles (tile.json, tile.mvt et count). Il définit la devise des prix de l’énergie renvoyés et utilisés pour le filtrage.

• Lorsque currency est omis, connector_minimum_energy_price et connector_maximum_energy_price sont renvoyés en EUR.
• Lorsque currency est un code de devise ISO 4217 valide, tel que USD, GBP, DKK ou EUR :
  • Les valeurs renvoyées dans connector_minimum_energy_price et connector_maximum_energy_price sont converties de leur devise d’origine vers la devise demandée côté serveur, à l’aide du taux de conversion actif.
  • Les filtres minimum_energy_price et maximum_energy_price sont évalués sur les prix convertis dans la devise demandée, ou en EUR si currency est omis.
• Lorsque la devise d’origine est identique à la devise demandée, price_conversion_rate est renvoyé avec la valeur 1.0.
• Lorsque currency n’est pas un code de devise ISO 4217 valide, le service de tuiles renvoie une erreur avec les détails suivants :
  • Statut : 400 Bad Request
  • Code : TILE_INVALID_PARAMETER_VALUE
  • Message : Invalid parameter 'currency': found string {invalid currency} but expected one of {supported currencies}.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=USD

Exemples

Pour illustrer le comportement, des exemples de filtrage et de transformation des données sont fournis ci-dessous.

Exemples de filtres

Les filtres peuvent exister à deux niveaux : au niveau de l’EVSE ou au niveau de la station, chacun avec son propre impact et ses propres résultats, comme décrit ci-dessous.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=120&evse_statuses[]=AVAILABLE&connectors[]=IEC_62196_T1_COMBO

Exemples de transformation des données

Certaines sorties sont recalculées lorsque des filtres au niveau de l’EVSE sont appliqués. Ces champs sont « transformés » pour ignorer les connecteurs qui ne correspondent pas aux critères de recherche de l’utilisateur. Ces champs de sortie « dynamiques » sont connector_maximum_power, connector_minimum_energy_price, connector_maximum_energy_price et evse_status_*.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO

{  "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}

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

{  "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}

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

{  "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}

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

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