Aller au contenu principal
Guide

Itinéraire avec opérateurs préférés

Les préférences d’opérateur vous permettent de contrôler quels réseaux de recharge le service de calcul d’itinéraire privilégie lors du calcul d’un itinéraire EV.

Vous pouvez configurer les préférences à deux endroits :

  • Dashboard Chargetrip : définissez la configuration globale des préférences d’opérateur pour votre projet sous project / advanced / station operator preferences.
  • Requête Create Route : définissez les préférences dynamiquement ou remplacez la configuration des préférences d’opérateur du dashboard pour chaque requête à l’aide du champ input.operators de la mutation createRoute.

1. Types de préférences et comportement de l’itinéraire

Les préférences d’opérateur existent en quatre types, et chacune peut être limitée à des pays spécifiques :

PréférenceComportement du calcul d’itinéraire
ExcluLes stations de ces opérateurs sont strictement exclues en toutes circonstances.
ÉvitéLes stations de ces opérateurs sont évitées, sauf s’il n’existe aucune meilleure alternative.
PréféréLes stations de ces opérateurs sont priorisées selon leur classement (high, medium, low). Plus le niveau est élevé, plus la station a de chances d’être sélectionnée. L’itinéraire utilisera tout de même des stations non classées ou évitées s’il n’existe aucune meilleure alternative.
ObligatoireSeules les stations de ces opérateurs sont utilisées. Au sein de ce groupe autorisé, les niveaux de classement s’appliquent toujours, ce qui signifie que les opérateurs de rang élevé sont préférés à ceux de rang moyen et faible. Si le véhicule ne peut pas atteindre la destination en n’utilisant que des stations classées, le calcul de l’itinéraire échoue.

2. Comment les préférences du dashboard sont appliquées

Comprendre comment les entrées au niveau de la requête interagissent avec les paramètres du dashboard garantit un comportement de calcul d’itinéraire prévisible :

  • Les opérateurs exclus et évités du dashboard s’appliquent automatiquement : Les opérateurs configurés comme exclus ou évités dans le dashboard s’appliquent à chaque calcul d’itinéraire sans nécessiter aucun paramètre dans votre requête createRoute.
  • Les niveaux de classement du dashboard restent inactifs sans type de classement : Les opérateurs configurés dans des niveaux de classement doivent être activés en définissant input.operators.ranking.type dans votre requête createRoute, faute de quoi ils n’influencent pas la sélection des stations.
  • Les opérateurs au niveau de la requête remplacent les préférences correspondantes du dashboard : Spécifier des identifiants d’opérateur dans la requête createRoute ne remplace que la configuration correspondante du dashboard. Par exemple, fournir input.operators.exclude[] remplace l’intégralité de la configuration des opérateurs exclus du dashboard, tandis que les opérateurs évités du dashboard continuent de s’appliquer.

3. Exemples d’implémentation

Utiliser uniquement les exclusions et les évitements du dashboard Applique les configurations d’opérateurs exclus et évités définies dans le dashboard. Les paramètres de classement du dashboard sont inactifs car aucun input.operators.ranking.type n’est spécifié.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }  })

Utiliser les opérateurs classés du dashboard comme « Préférés » Applique les configurations d’opérateurs exclus et évités du dashboard, et privilégie les stations appartenant aux niveaux de classement du dashboard.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: preferred      }    }  })

Utiliser les opérateurs classés du dashboard comme « Obligatoires » Limite l’itinéraire à une recharge exclusivement dans les stations appartenant aux opérateurs configurés dans les niveaux de classement du dashboard.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: required      }    }  })

Définir des préférences personnalisées et remplacer les paramètres du dashboard Fournissez des configurations d’opérateurs complètes directement dans l’appel d’API. Tout champ spécifié (ranking, avoid ou exclude) remplace la configuration correspondante du dashboard pour cette requête.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: preferred        level: {          high: [{ id: "5e8c22366f9c5f23ab0eff01" }]          medium: [{ id: "5e8c22366f9c5f23ab0eff02" }]        }      }      avoid: [{ id: "5e8c22366f9c5f23ab0eff03" }]      exclude: [{ id: "5e8c22366f9c5f23ab0eff04" }]    }  })

Définir des préférences personnalisées pour des pays spécifiques Fournissez des configurations d’opérateurs complètes directement dans l’appel d’API. Tout champ spécifié (ranking, avoid ou exclude) remplace la configuration correspondante du dashboard pour cette requête.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: preferred        level: {          high: [{ id: "5e8c22366f9c5f23ab0eff01", countries: ["NL", "DE"] }]          medium: [{ id: "5e8c22366f9c5f23ab0eff01", countries: ["FR"] }]        }      }      avoid: [{ id: "5e8c22366f9c5f23ab0eff03", countries: ["AT"] }]      exclude: [{ id: "5e8c22366f9c5f23ab0eff04" }]    }  })

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.