Vai al contenuto principale

Sviluppatori

Dashboard
Dashboard
Subscription
Deprecato

Percorso aggiornato per ID

Guida alla migrazione

Dettagli del percorso

Esegui la migrazione entro: Q1 2027

Passa dal servizio Route legacy alla versione più recente. Il nuovo servizio offre uno schema riorganizzato, preferenze degli operatori per paese, un calcolo del percorso più rapido e maggiore manutenibilità.

Operazioni

PrecedenteNuovo
routegetRoute
routeUpdatedByIdroute

Modifiche generali allo schema

  • Tipizzazione esplicita: i campi JSON in precedenza flessibili sono ora 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 opzionale (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.

Livello superiore

Al livello superiore, la maggior parte dei campi si sposta sotto recommended, mentre 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 rinomine 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 rinomine del percorso, mentre i dettagli su occupanti e carico si spostano nelle 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

I passaggi (steps) sono stati sostituiti dalle sezioni, che forniscono informazioni più granulari, inclusi i dettagli di origine e destinazione di ciascuna sezione.

Sections
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    }  }}

Sottoscrivi un percorso utilizzando la subscription legacy routeUpdatedById per ricevere aggiornamenti in tempo reale durante il suo calcolo. Le nuove integrazioni dovrebbero invece usare la subscription route.

Argomenti

id· ID · obbligatorio

Campi

telemetry· JSON
Route telemetry data.
status· RouteStatus
Route status.
Valori enum di RouteStatus
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 qui.

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_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 ©

Gestisci i cookie

In vigore dal: 20 marzo 2024 · Aggiornato il: 1 settembre 2026

Utilizziamo i cookie per migliorare la tua esperienza su developers.chargetrip.com. Questa informativa 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 proprio servizio, anche se non sono coperti dalla nostra informativa.

Se non desideri accettare alcun cookie da parte nostra, devi impostare il tuo browser in modo che rifiuti i cookie di developers.chargetrip.com, tenendo presente che potremmo non essere in grado di offrirti alcuni dei contenuti e dei servizi desiderati.

Un cookie è un piccolo dato 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 legati alla finalità del cookie stesso e la durata del cookie.

I cookie vengono utilizzati per abilitare determinate funzionalità (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 monitorano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ossia terze parti) possono essere utilizzati per monitorarti su altri siti web che usano 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 monitorano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ossia terze parti) possono essere utilizzati per monitorarti su altri siti web che usano 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 per 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 (di prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per monitorarti su altri siti web che usano lo stesso servizio di terze parti. Sul nostro sito utilizziamo cookie di targeting/pubblicitari.

Cookie di marketing / pubblicitari

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e per 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 (di prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per monitorarti su altri siti web che usano lo stesso servizio di terze parti. Sul nostro sito utilizziamo cookie di targeting/pubblicitari.

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, così da rispettare la tua scelta a ogni visita e caricare solo gli strumenti di analisi o di marketing che hai consentito.
Durata
2 anni

Se non desideri accettare cookie da parte nostra, puoi impostare il tuo browser in modo che rifiuti 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, potrebbe essere necessario aggiornare le impostazioni su ciascun dispositivo.

Sebbene alcuni cookie possano essere bloccati con un impatto minimo sull’esperienza di un sito web, bloccare tutti i cookie potrebbe impedirti di accedere a determinate funzionalità e contenuti dei siti che visiti.

Potremmo aggiornare periodicamente questa Informativa sui cookie per riflettere, ad esempio, modifiche ai cookie che utilizziamo o per altri motivi operativi, legali o normativi. Ti invitiamo a consultare nuovamente questa Informativa sui cookie per restare informato sul nostro utilizzo dei cookie e delle tecnologie correlate. La data indicata all’inizio di questa Informativa sui cookie indica quando è stata aggiornata l’ultima volta.