Vai al contenuto principale

Sviluppatori

Dashboard
Dashboard
Query
Deprecato

Percorso

Guida alla migrazione

Dettagli del percorso

Migra entro: Q1 2027

Esegui la migrazione dal servizio Route legacy all’ultima versione. Il nuovo servizio offre uno schema riorganizzato, preferenze degli operatori per paese, un calcolo del percorso più veloce e una maggiore manutenibilità.

Operazioni

PrecedenteNuovo
routegetRoute
routeUpdatedByIdroute

Modifiche generali allo schema

  • Tipizzazione esplicita: i campi JSON in precedenza flessibili ora sono tipizzati esplicitamente nello schema per migliorare struttura e validazione.
  • Convenzioni di denominazione: i campi ora usano snake_case invece di camelCase.
  • Supporto delle unità: gli input numerici ora supportano diversi tipi di unità, espressi come oggetto con value, type e un source facoltativo (manual, telemetry o default).

Modifiche a query e subscription

La denominazione e il raggruppamento dei campi sono stati rivisti e i campi ridondanti sono stati rimossi. La risposta ora include l’input originale arricchito con i valori predefiniti, così può essere riutilizzato per futuri ricalcoli del percorso.

Primo livello

Al primo livello, la maggior parte dei campi si sposta sotto recommended, e gli input ev, telemetry e routeRequest vengono riuniti in un unico oggetto request_input.

CampoSpostato in
routerecommended
alternativesRimosso
evrequest_input
telemetryrequest_input
routeRequestrequest_input
appmeta.app_id
statusInvariato

Percorso

A livello di percorso, la maggior parte dei campi si sposta sotto recommended, mantenendo i propri nomi, insieme ad alcune ridenominazioni esplicite.

CampoSpostato in
rangeStart*range_at_origin
rangeEnd*range_at_destination
chargesrecommended.charges
distancerecommended.distance
consumptionrecommended.consumption
chargeTimerecommended.durations.charging
polylinerecommended.polyline
pathPlotrecommended.path_plot
legsrecommended.legs
tagsrecommended.tags
instructionsRimosso
amenityRankingRimosso
stationsAlongRouterecommended.alternative_stations

Tratte

A livello di tratta, le autonomie seguono le stesse ridenominazioni del percorso, e i dettagli su occupanti e carico si spostano sulle proprietà di posizione origin e via di ciascuna tratta.

CampoSpostato in
rangeStart*range_at_origin
rangeEnd*range_at_destination
stepssections
stationIdrecommended.legs.station.station_id

Le tratte ottengono inoltre un nuovo campo range_after_charge.

Modifiche in evidenza

La risposta introduce anche una nuova struttura, più organizzata, per le sezioni del percorso. È descritta più in dettaglio di seguito.

Sezioni

Gli step sono stati sostituiti dalle sezioni, che forniscono informazioni più granulari, inclusi i dettagli di origine e destinazione per ciascuna sezione.

Sezioni
graphql
sections {  type  tags  polyline(decimals: five)  distance(unit: meter)  duration  consumption  origin {    id    type    properties {      occupants      total_occupant_weight      total_cargo_weight    }    geometry {      type      coordinates    }  }  destination {    id    type    properties {      occupants      total_occupant_weight      total_cargo_weight    }    geometry {      coordinates      type    }  }}

Ottieni i dettagli di un percorso calcolato in precedenza usando la query legacy route. Le nuove integrazioni dovrebbero usare invece la query getRoute.

Argomenti

id· ID· required

Campi

route· RouteAlternative
Recommended route.
alternatives· RouteAlternative
Available alternatives.
ev· RequestEv
EV specific data for a route request.
telemetry· JSON
Route telemetry data.
user· RequestUser· You will receive null values.
routeRequest· RequestRoute
Route request data.
app· RouteApp
Application who requested a route.
status· RouteStatus
Route status.
RouteStatus enum values
pending

Route is queued and pending processing. Temporary status.

processing

We are computing the route for your request. Temporary status.

done

We finished computing the route, with a result. Final status.

not_found

We finished computing the route, without any result. Final status.

error

An error occurred while computing the route. Final status.

Errori

Le operazioni possono non riuscire. Tieni conto dei seguenti scenari di errore per gestirli correttamente. Ulteriori informazioni sugli errori 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_not_found
No route was found with the provided ID.
route_polyline_invalid_decimals
Value for decimals number is not valid. Allowed values are 5 or 6.

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.