Vai al contenuto principale
Mutation
Deprecato

Nuovo percorso

Guida alla migrazione

Crea 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
newRoutecreateRoute

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 alla mutation

L’argomento input di createRoute è stato riorganizzato e semplificato.

routeRequest

A livello radice, i seguenti campi sono stati rimossi. I campi relativi agli operatori sono ora coperti dalle preferenze degli operatori, mentre quelli relativi ai servizi sono stati spostati nella loro query dedicata per i servizi.

CampoSpostato in
operatorIdsRimosso
amenitiesRimosso
amenity_preferencesRimosso
operatorRequiredRimosso
operatorPreferRimosso

EV

A livello di EV, la maggior parte dei campi di primo livello è stata spostata in un oggetto dedicato vehicle.

CampoSpostato in
ev.idvehicle.id
batteryvehicle
climatevehicle
heat_pumpvehicle
plugsvehicle.charging.connectors
safeRiskMarginvehicle.charging.risk_margin
chargeModevehicle.charging.mode
bmsConsumptionRimosso

Carico del veicolo

Le proprietà del carico del veicolo non vengono più impostate in un unico punto. Ora sono specificate per ciascun punto origin e via, offrendo un controllo più granulare sul peso di occupanti e carico per ogni tratta. Si trovano sotto properties.vehicle di ciascuna posizione, e i nomi dei loro campi cambiano come segue:

CampoSpostato in
occupantsInvariato
cargototal_cargo_weight

Telemetria

I seguenti dati di telemetria sono stati spostati dal livello radice all’oggetto vehicle.

CampoSpostato in
headingvehicle
motor_rpmvehicle
odometervehicle
outside_temperaturevehicle
tire_pressurevehicle
vehicle_speedvehicle

Modifiche in evidenza

Alcuni campi dell’argomento input hanno ora strutture nuove e più organizzate. Sono descritti più in dettaglio di seguito.

Preferenze degli operatori

Le preferenze degli operatori sono semplificate in tre livelli: high, medium e low. Ogni voce, che sia in classifica, esclusa o da evitare, può essere limitata a paesi specifici tramite il campo countries. Se omesso, vengono considerati tutti i paesi.

Preferenze degli operatori
graphql
input: {  operators: {    ranking: {      type: preferred      levels: {        high: [          {            id: "op1"            countries: [NL]          }        ]        low: [          {            id: "op3"          }        ]      }    }  }}

Peso totale degli occupanti

Un nuovo campo total_occupant_weight ti consente di sostituire il peso predefinito degli occupanti, espresso con il nuovo oggetto unità.

Peso totale degli occupanti
graphql
input: {  origin: {    properties: {      vehicle: {        occupants: 3        total_occupant_weight: {          value: 160          type: kilogram          source: manual        }      }    }  }}

Crea un nuovo percorso usando la mutation legacy newRoute. Resta disponibile mentre migri alla mutation createRoute, che calcola tappe di ricarica, consumo energetico e tempo di guida con uno schema riorganizzato e preferenze degli operatori per paese.

Argomenti

input· RequestInput

Campi

ID· ID· In favor of createRoute.

Le operazioni possono non riuscire. Tieni conto dei seguenti scenari di errore per gestirli correttamente. Ulteriori informazioni sugli errori here.

consumption_exceeded
Provided consumption value for $LOCATION is not valid. The value must be between 0 and $MAXVALUE kwh, or the equivalent in another unit, for this vehicle.
empty_array_not_allowed
Array $NAME should have at least one value.
error_forbidden_message
You are forbidden to execute this operation.
invalid_coordinates
Coordinates provided for $LOCATION are not valid.
invalid_unit
Provided unit type $TYPE for $LOCATION is not valid.
invalid_value
Provided value $VALUE for $LOCATION is not valid. Expected value of type $EXPECTEDTYPE.
negative_value_not_allowed
Negative value for $LOCATION is not allowed.
occupants_above_allowed
Provided number of occupants for $LOCATION is not valid. The value must be less than or equal to $OCCUPANTSCOUNT for this vehicle.
occupants_below_allowed
Provided number of occupants for $LOCATION is not valid. The value must be at least 1.
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.
operator_both_excluded_and_ranking
Operator $OPERATORID is both in the ranking and excluded lists.
operator_duplicated_in_exclude
Operator $OPERATORID is multiple times in the exclude lists.
operator_duplicated_in_ranking
Operator $OPERATORID is multiple times in the ranking lists.
operator_invalid_ranking
Operator ranking must be between 1 and 10.
operator_not_found
No operator was found with the $OPERATORID ID.
operator_ranking_none_given
The route operator type was set to $ROUTEOPTYPE, but no ranking was provided. Please add an operator to your client or route request.
rate_limit_exceeded
Rate limit exceeded.
route_battery_capacity_above_allowed
The provided battery capacity is too high. The value must be less than or equal to $MAX kwh or the equivalent in another unit.
route_battery_capacity_below_allowed
The provided battery capacity is too small. The value must be greater than or equal to $MIN kwh or the equivalent in another unit.
route_cargo_below_allowed
Provided amount of cargo weight is not valid. The value cannot be negative.
route_consumption_invalid_worst
Provided consumption value for $NAME is not valid. The worst value must be greater than or equal to best value.
route_consumption_total_exceeded
Provided consumption values are not valid. The total must be between 0 and $MAXVALUE for this vehicle.
route_destination_station_and_external_station_not_matching
The destination station for the route requested was not matched with the external station.
route_destination_station_invalid_speed
The provided destination station $STATIONID cannot be used as charging stop. The station does not support DC charging (> 43kW).
route_destination_station_not_found
The destination station for the route requested was not found with the provided ID.
route_destination_station_out_of_service
The provided destination station $STATIONID cannot be used as charging stop. All compatible connectors at this station are out of service.
route_duplicate_amenities
Amenities $DUPLICATEDAMENITIES are duplicated.
route_final_soc_exceeding_battery_capacity
The provided final state of charge is too high. The value must be less than or equal to 80% of the vehicle battery capacity.
route_invalid_amenities
Amenities $INVALIDAMENITIES are not valid. Allowed: $ALLOWEDAMENITIES.
route_invalid_destination_coordinates
The destination coordinates provided are not valid.
route_invalid_origin_coordinates
The origin coordinates provided are not valid.
route_invalid_scheduled_charge_stop_duration
The scheduled charge stop duration is invalid. The value must be between 900 and 86400 seconds.
route_invalid_scheduled_charge_stop_max_distance_from_station
The scheduled charge stop max_distance_from_station is invalid. The value must be between 0 and 1000 meters.
route_invalid_via_coordinates
The via coordinates provided are not valid.
route_max_number_of_passengers_exceeded
Provided number of passengers is not valid. The value must be between 1 and $PASSENGERCOUNT for this vehicle.
route_min_power_below_allowed
The provided minimum power is too small. The value must be greater than 0.
route_origin_station_and_external_station_not_matching
The origin station for the route requested was not matched with the external station.
route_origin_station_not_found
The origin station for the route requested was not found with the provided ID.
route_radius_above_allowed
The radius value is above allowed, the maximum value is 5000 meters.
route_radius_below_allowed
The radius value is below allowed, the minimum value is 500 meters.
route_station_invalid_charger
The provided via station $STATIONID cannot be used as charging stop. The charger standard of the vehicle is not supported.
route_station_invalid_min_power
The minimum power requested is higher than the station could support.
route_station_invalid_speed
The provided via station $STATIONID cannot be used as charging stop. The station does not support DC charging (> 43kW).
route_station_out_of_service
The provided via station $STATIONID cannot be used as charging stop. All compatible connectors at this station are out of service.
route_via_cargo_below_allowed
Provided amount of cargo is not valid. The value must be greater than 0.
route_via_station_and_external_station_not_matching
The via station for the route requested was not matched with the external station.
route_via_station_not_found
The station ID used as a via for the requested route was not found.
soc_exceeding_battery_capacity
The provided state of charge for $LOCATION is too high. The value must be less than or equal to the vehicle battery capacity.
station_destination_coordinates_not_matching
Coordinates [$DESTINATIONCOORDINATES] of destination don't match with station coordinates [$STATIONCOORDINATES].
station_origin_coordinates_not_matching
Coordinates [$ORIGINCOORDINATES] of origin don't match with station coordinates [$STATIONCOORDINATES].
station_via_coordinates_not_matching
Coordinates [$VIACOORDINATES] of via don't match with station coordinates [$STATIONCOORDINATES].
tire_pressure_below_allowed
Provided tire pressure is not valid. The value must be at least 1.
vehicle_freemium_not_allowed
You do not have access to this vehicle. Please upgrade to access this vehicle.
vehicle_type_not_allowed
Vehicle of type $TYPE is not allowed for this operation.
zero_or_negative_value_not_allowed
Zero or negative value for $LOCATION is not allowed.

Questo contenuto ti è stato utile?

Sviluppatori

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.

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.