Aller au contenu principal
Rest

Sélecteurs

Pour optimiser le temps de réponse et la taille, l’API MVT et l’API JSON renvoient par défaut une réponse minimisée. Cette approche garantit des performances optimales et réduit la taille des tuiles, ce qui est essentiel pour des interactions fluides avec la carte. Grâce aux sélecteurs, vous pouvez inclure les données supplémentaires dont votre application a spécifiquement besoin.

Sélecteurs disponibles

Tout champ listé dans les propriétés de station des tuiles MVT et JSON peut être utilisé comme sélecteur dans son service respectif, à l’exception des champs GeoJSON obligatoires renvoyés par l’endpoint JSON.

count · integer · default
Le nombre de stations dans un cluster. Un nombre de 1 signifie une feature Station, tandis qu’un nombre supérieur à 1 signifie une feature Cluster.
expansion_zoom · integer · default
Le niveau de zoom auquel un cluster se divise en plusieurs clusters ou stations plus petits.
id · string
L’identifiant de la station.
lng · float
La longitude de la station.
lat · float
La latitude de la station.
station_maximum_power · integer
La puissance de charge maximale de la station (en kW) disponible à la station. Cette valeur est statique et reflète toujours la capacité maximale de la station, quels que soient les filtres de connecteurs.
connector_maximum_power · integer
La puissance de charge maximale (en kW) disponible sur les connecteurs correspondant au filtre connectors[]. Si aucun filtre n’est fourni, tous les connecteurs sont pris en compte et elle est égale à station_maximum_power.
preferred_operator · boolean
Indique si l’opérateur d’une station est un opérateur préféré. Les opérateurs préférés peuvent être gérés au niveau du projet dans le Dashboard.
connector_minimum_energy_price · float · Bêta Ce champ est en bêta et peut changer avant de devenir stable.
Le prix de l’énergie le plus bas parmi les connecteurs de la station. Non renvoyé s’il n’est pas disponible.
connector_maximum_energy_price · float · Bêta Ce champ est en bêta et peut changer avant de devenir stable.
Le prix de l’énergie le plus élevé parmi les connecteurs de la station. Non renvoyé s’il n’est pas disponible.
price_vat · float · Bêta Ce champ est en bêta et peut changer avant de devenir stable.
La TVA appliquée au prix. Non renvoyé s’il n’est pas disponible.
price_valid_until · string · Bêta Ce champ est en bêta et peut changer avant de devenir stable.
La date et l’heure jusqu’auxquelles le prix est valable. Non renvoyé s’il n’est pas disponible.
price_original_currency · string · Bêta Ce champ est en bêta et peut changer avant de devenir stable.
La devise dans laquelle le prix était initialement défini, avant conversion en currency. Non renvoyé s’il n’est pas disponible.
price_conversion_rate · float · Bêta Ce champ est en bêta et peut changer avant de devenir stable.
Le taux utilisé pour convertir le prix de sa devise d’origine en currency. Non renvoyé s’il n’est pas disponible.
evse_status_blocked · integer
Le nombre d’EVSE au statut bloqué. Si un filtre connectors[] est fourni, seuls les EVSE bloqués correspondant aux types de connecteurs sélectionnés sont comptés.
evse_status_planned · integer
Nombre d’EVSE au statut planifié. Si un filtre connectors[] est fourni, seuls les EVSE planifiés ayant au moins un des types de connecteurs sélectionnés sont comptés.
evse_status_available · integer
Nombre d’EVSE au statut disponible. Si un filtre connectors[] est fourni, seuls les EVSE disponibles ayant au moins un des types de connecteurs sélectionnés sont comptés.
evse_status_charging · integer
Nombre d’EVSE au statut en charge. Si un filtre connectors[] est fourni, seuls les EVSE en charge ayant au moins un des types de connecteurs sélectionnés sont comptés.
evse_status_unknown · integer
Nombre d’EVSE au statut inconnu. Si un filtre connectors[] est fourni, seuls les EVSE inconnus ayant au moins un des types de connecteurs sélectionnés sont comptés.
evse_status_reserved · integer
Nombre d’EVSE au statut réservé. Si un filtre connectors[] est fourni, seuls les EVSE réservés ayant au moins un des types de connecteurs sélectionnés sont comptés.
evse_status_out_of_order · integer
Nombre d’EVSE au statut out_of_order. Si un filtre connectors[] est fourni, seuls les EVSE hors service ayant au moins un des types de connecteurs sélectionnés sont comptés.
evse_status_inoperative · integer
Nombre d’EVSE au statut inoperative. Si un filtre connectors[] est fourni, seuls les EVSE inopérants ayant au moins un des types de connecteurs sélectionnés sont comptés.

Implémentation

Pour demander des propriétés spécifiques, ajoutez le paramètre de requête station_properties[] à l’URL de la requête de tuile.

Tile / Selectors / Example
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?station_properties[]={selector1}&station_properties[]={selector2}&station_properties[]={selector3}

Exemples de comportement

Lorsque des sélecteurs sont fournis, la requête ne renvoie que les champs spécifiés.

GeoJSON

Dans l’endpoint GeoJSON, les champs GeoJSON obligatoires (type, geometry et id) sont toujours renvoyés, quels que soient les sélecteurs choisis.

JSON Selectors example
json
{  "type": "FeatureCollection",  "features": [    // Station feature    {      "id": "132313",      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [6.789, 52.234]      },      // 'count' is missing because it wasn't provided as selector      "properties": {        "station_maximum_power": 350,        "preferred_operator": true      }    },    // Cluster feature    // Cluster feature is not modified, as it's not affected by the selectors.    {      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [6.723, 50.0]      },      "properties": {        "count": 3,        "expansion_zoom": 18      }    }  ]}

MVT

Dans l’endpoint MVT, seuls les paramètres explicitement sélectionnés sont renvoyés, car il n’y a aucun champ obligatoire.

MVT Selectors example
json
// Station feature// 'count' is missing because it wasn't provided as a selector.{  "id": "132313",  "preferred_operator": false,  "station_maximum_power": 350}// Cluster feature// Cluster feature is not modified, as it's not affected by the selectors.{  "count": 3,  "expansion_zoom": 32}

Ce contenu vous a-t-il été utile ?

Développeurs

Chargetrip ©

Statut inconnu

Gérer les cookies

En vigueur le : 20 mars 2024 · Mis à jour le : 25 janvier 2023

Politique relative aux cookies

Nous utilisons des cookies pour améliorer votre expérience sur developers.chargetrip.com. Cette politique relative aux cookies fait partie de la politique de confidentialité et couvre l’utilisation des cookies entre votre appareil et notre site. Nous fournissons également des informations de base sur les services tiers que nous pouvons utiliser, qui peuvent eux aussi utiliser des cookies dans le cadre de leur service, bien qu’ils ne soient pas couverts par notre politique.

Si vous ne souhaitez accepter aucun cookie de notre part, vous devez configurer votre navigateur pour qu’il refuse les cookies de developers.chargetrip.com, en sachant que nous pourrions alors ne pas être en mesure de vous fournir certains des contenus et services souhaités.

Vérifier vos choix de consentement aux cookies

Un cookie est une petite donnée qu’un site web stocke sur votre appareil lors de votre visite. Il contient généralement des informations sur le site lui-même, un identifiant unique permettant au site de reconnaître votre navigateur à votre retour, des données supplémentaires répondant à la finalité du cookie, ainsi que la durée de vie du cookie.

Les cookies sont utilisés pour activer certaines fonctionnalités (par ex. la connexion), pour suivre l’utilisation du site (par ex. les analyses), pour stocker vos paramètres utilisateur (par ex. le fuseau horaire, les préférences de notification) et pour personnaliser votre contenu (par ex. la publicité, la langue).

Les cookies définis par le site web que vous visitez sont généralement appelés « cookies internes » (first-party) et ne suivent en principe que votre activité sur ce site particulier. Les cookies définis par d’autres sites et entreprises (c’est-à-dire des tiers) peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers.

Cookies essentiels

Les cookies définis par le site web que vous visitez sont généralement appelés « cookies internes » (first-party) et ne suivent en principe que votre activité sur ce site particulier. Les cookies définis par d’autres sites et entreprises (c’est-à-dire des tiers) peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers.

Cookies de performance

Les cookies de ciblage / publicitaires sont utilisés pour déterminer quel contenu promotionnel est le plus pertinent et approprié pour vous et vos centres d’intérêt. Les sites web peuvent les utiliser pour diffuser de la publicité ciblée ou pour limiter le nombre de fois où vous voyez une publicité. Cela aide les entreprises à améliorer l’efficacité de leurs campagnes et la qualité du contenu qui vous est présenté. Ces cookies peuvent être définis par le site web que vous visitez (first-party) ou par des services tiers. Les cookies de ciblage / publicitaires définis par des tiers peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers. Nous utilisons des cookies de ciblage / publicitaires sur notre site.

Cookies marketing / publicitaires

Les cookies de ciblage / publicitaires sont utilisés pour déterminer quel contenu promotionnel est le plus pertinent et approprié pour vous et vos centres d’intérêt. Les sites web peuvent les utiliser pour diffuser de la publicité ciblée ou pour limiter le nombre de fois où vous voyez une publicité. Cela aide les entreprises à améliorer l’efficacité de leurs campagnes et la qualité du contenu qui vous est présenté. Ces cookies peuvent être définis par le site web que vous visitez (first-party) ou par des services tiers. Les cookies de ciblage / publicitaires définis par des tiers peuvent être utilisés pour vous suivre sur d’autres sites web qui utilisent le même service tiers. Nous utilisons des cookies de ciblage / publicitaires sur notre site.

Engagement envers les tiers

Nous examinons les politiques de confidentialité de tous nos prestataires tiers avant de faire appel à leurs services, afin de nous assurer que leurs pratiques sont conformes aux nôtres. Nous n’inclurons jamais sciemment des services tiers qui compromettent ou violent la vie privée de nos utilisateurs.

Cookie
google-cookie-consent
Description
Stocke vos préférences en matière de cookies, c’est-à-dire les catégories que vous avez acceptées ou refusées, afin que nous puissions respecter votre choix à chaque visite et ne charger que les outils d’analyse ou de marketing que vous avez autorisés.
Durée de vie
2 ans

Comment contrôler ou refuser les cookies

Si vous ne souhaitez pas accepter les cookies de notre part, vous pouvez configurer votre navigateur pour qu’il refuse les cookies de notre site web. La plupart des navigateurs sont configurés par défaut pour accepter les cookies, mais vous pouvez modifier ces paramètres pour refuser complètement les cookies ou pour être averti lorsqu’un site web tente d’en définir un.

Si vous naviguez sur des sites web depuis plusieurs appareils, vous devrez peut-être modifier vos paramètres sur chacun d’eux.

Bien que certains cookies puissent être bloqués sans grand impact sur l’expérience d’un site web, bloquer tous les cookies peut vous empêcher d’accéder à certaines fonctionnalités et à certains contenus sur les sites que vous visitez.

Nous pouvons mettre à jour cette politique relative aux cookies de temps à autre afin de refléter, par exemple, des changements dans les cookies que nous utilisons ou pour d’autres raisons opérationnelles, juridiques ou réglementaires. Veuillez consulter à nouveau cette politique pour rester informé de notre utilisation des cookies et des technologies associées. La date en haut de cette politique relative aux cookies indique la dernière fois qu’elle a été mise à jour.