Aller au contenu principal

Développeurs

Tableau de bord
Tableau de bord
Query
Obsolète

Chemin de l'itinéraire

Guide de migration

routePath

Migrer avant : T1 2027

Migrez de l’ancien service Route vers la dernière version. Le nouveau service offre un schéma réorganisé, des préférences d’opérateur par pays, un calcul d’itinéraire plus rapide et une meilleure maintenabilité.

Opérations

AncienNouveau
routePathgetRoute

Changements généraux du schéma

  • Typage explicite : les champs JSON auparavant flexibles sont désormais explicitement typés dans le schéma pour améliorer la structure et la validation.
  • Conventions de nommage : les champs utilisent désormais snake_case au lieu de camelCase.
  • Prise en charge des unités : les entrées numériques prennent désormais en charge différents types d’unités, exprimées sous la forme d’un objet avec value, type et une source facultative (manual, telemetry ou default).

Changements de requête

Le chemin de l’itinéraire est désormais déjà inclus dans la réponse getRoute sous recommended.path_plot, une requête distincte pour le récupérer n’est donc plus nécessaire.

Obtenez le chemin d’un itinéraire précédemment calculé à l’aide de la requête routePath. Elle est utile lorsque vous souhaitez afficher la polyligne d’un itinéraire sur une carte.

Arguments

id· ID· required
ID of a route that you require for a route path segment
location· PointInput· required
The GeoJSON Point of a route path segment
alternativeId· ID
Optional alternative ID. By default we will retrieve the fastest route

Champs

location· Point
GeoJSON location of a route path segment.
elevation· Int
Elevation (altitude) in meters.
averageSpeed· Float
Average speed, in km/h, for this route path segment.
recommendedSpeed· Float
Recommended speed, in km/h for this route path segment to optimise the consumption.
consumption· Float
Consumption, in kWh, of a route path segment.
consumptionPerKm· Float
Consumption, in kWh per km, of a route path segment.
distance· Float
Distance, in meters, of a route path segment.
duration· Float
Duration, in seconds, of a route path segment.
stateOfCharge· Float
State of charge, in kWh, of a route path segment.

Erreurs

Les opérations peuvent échouer. Tenez compte des scénarios d'erreur suivants pour les gérer correctement. Plus sur les erreurs here.

error_forbidden_message
You are forbidden to execute this operation.
operation_not_allowed
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
rate_limit_exceeded
Rate limit exceeded.
route_invalid_safe_risk_margin
Safe risk margin needs to be a value between 0 and 60.
route_not_found
No route was found with the provided ID.
route_path_invalid_point_coordinates
The coordinates provided are not valid.
route_path_location_not_found
No location was found with the provided input.
route_path_not_found
No route path was found with the provided ID or alternative ID.

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

Créer

Développeurs

Mises à jour

Ressources

Mentions légales

Nous contacter

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.