@chargetrip/types 1.48.0 → 1.50.0

package/dist/ts/graphql.d.ts

@@ -469,6 +469,16 @@ export declare enum ChargingBehaviourCode {
     /** Mainly morning charging, with some afternoon charging. */
     OFFICE_CHARGING = "OFFICE_CHARGING"
 }
+export declare enum CongestionLevel {
+    /** Congestion level is unknown or could not be determined. */
+    UNKNOWN = "unknown",
+    /** Traffic is flowing freely with little to no delay. */
+    LOW = "low",
+    /** Increased traffic volume causing minor delays. */
+    MEDIUM = "medium",
+    /** Significant traffic volume causing heavy delays and potential standstills. */
+    HIGH = "high"
+}
 export declare type Connect = {
     /** List of connectivity providers to which the vehicle can connect. This field returns null for free users. Please contact customer success for more information. */
     providers?: Maybe<Array<ConnectProvider>>;
@@ -1207,6 +1217,8 @@ export declare type CreateRoute = {
     weather?: Maybe<RouteWeather>;
     /** Charging stations preferences for route calculation. */
     station_preferences?: Maybe<RouteStationPreferences>;
+    /** [BETA] Indicates whether current traffic conditions were considered during route calculation. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information. */
+    traffic_aware?: Maybe<Scalars["Boolean"]>;
 };
 /** Input for the create route mutation. */
 export declare type CreateRouteInput = {
@@ -1234,6 +1246,8 @@ export declare type CreateRouteInput = {
     station_preferences?: Maybe<RouteStationPreferencesInput>;
     /** [BETA] Configuration options for the route's driving conditions. Includes factors to adjust average speed, set a maximum speed, and define a base driving style. If not specified, no adjustments are applied. */
     driving_preferences?: Maybe<RouteDrivingPreferencesInput>;
+    /** [BETA] Route should consider current traffic conditions. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information. */
+    traffic_aware?: Maybe<Scalars["Boolean"]>;
 };
 /** Currency in the ISO 4217 format. */
 export declare enum Currency {
@@ -1674,6 +1688,9 @@ export declare type EmissionsFactor = {
     /** The base regional emissions factor in CO2e/kWh. */
     value: Scalars["Float"];
 };
+export declare type EmissionsFactorvalueArgs = {
+    unit?: Maybe<EmissionUnit>;
+};
 /** Emissions factor type. */
 export declare enum EmissionsFactorType {
     COUNTRY = "country",
@@ -3797,6 +3814,8 @@ export declare type RouteDetails = {
     charges: Scalars["Int"];
     /** [BETA] Warnings that certain conditions specified in a route mutation are not respected. */
     warnings?: Maybe<Array<RouteWarning>>;
+    /** [BETA] Information regarding traffic conditions along the route. Available for routes created with traffic_aware set. */
+    traffic?: Maybe<RouteDetailsTraffic>;
 };
 export declare type RouteDetailsdistanceArgs = {
     unit?: Maybe<DistanceUnit>;
@@ -3906,6 +3925,8 @@ export declare type RouteDetailsLeg = {
     sections: Array<RouteDetailsLegSection>;
     /** [BETA] Warnings that certain conditions specified in a route mutation are not respected. */
     warnings?: Maybe<Array<RouteDetailsLegWarning>>;
+    /** [BETA] Information regarding traffic conditions along the route's leg . Available for routes created with traffic_aware set to true. */
+    traffic?: Maybe<RouteDetailsLegTraffic>;
 };
 /** Leg of a route detail. */
 export declare type RouteDetailsLegdistanceArgs = {
@@ -4019,6 +4040,8 @@ export declare type RouteDetailsLegSection = {
     duration: Scalars["Float"];
     /** Total energy used in a section in kilowatt-hours. The value will be 0 for walking sections. */
     consumption?: Maybe<Scalars["Float"]>;
+    /** [BETA] Information regarding traffic conditions along the leg's section. Available for routes created with traffic_aware set to true. */
+    traffic?: Maybe<RouteDetailsLegSectionTraffic>;
 };
 export declare type RouteDetailsLegSectionpolylineArgs = {
     decimals?: Maybe<PolylineInputDecimals>;
@@ -4050,6 +4073,10 @@ export declare type RouteDetailsLegSectionFeaturePointPropertiestotal_occupant_w
 export declare type RouteDetailsLegSectionFeaturePointPropertiestotal_cargo_weightArgs = {
     unit?: Maybe<WeightUnit>;
 };
+export declare type RouteDetailsLegSectionTraffic = {
+    /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg's section. */
+    congestions: Array<TrafficCongestionInterval>;
+};
 /** Type of a route details leg section. */
 export declare enum RouteDetailsLegSectionType {
     DRIVING = "driving",
@@ -4064,6 +4091,10 @@ export declare type RouteDetailsLegStation = {
     /** ID of the connector that was selected in a route. */
     connector_id: Scalars["ID"];
 };
+export declare type RouteDetailsLegTraffic = {
+    /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg. */
+    congestions: Array<TrafficCongestionInterval>;
+};
 /** Type of a leg. */
 export declare enum RouteDetailsLegType {
     /** This leg ends at a charging station and the vehicle must recharge. */
@@ -4185,6 +4216,12 @@ export declare enum RouteDetailsTag {
     WALKING = "walking",
     CROSSBORDER = "crossborder"
 }
+export declare type RouteDetailsTraffic = {
+    /** [BETA] Additional driving duration, in seconds, caused by traffic congestion compared to free-flow conditions. This value is already included in route total and driving durations. */
+    delay: Scalars["Int"];
+    /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg. */
+    congestions: Array<Maybe<TrafficCongestionInterval>>;
+};
 export declare type RouteDrivingPreferences = {
     /** [BETA] Factor to adjust the route's calculated average speed. Accepts values between 0.80 and 1.20. 1.0 is neutral. Values below 1.0 reduce speed (e.g. 0.95 is -5%), values above increase it. If provided in combination with style, this overrides the speed factor implied by the selected 'style'. */
     speed_factor?: Maybe<Scalars["Float"]>;
@@ -4750,6 +4787,8 @@ export declare type RouteOperationalElectricityEmissionsIntensityinfrastructureA
 };
 /** Energy source models. */
 export declare enum RouteOperationalElectricityEnergySourceModel {
+    /** The current energy mix of the charging station provided by the CPO was used. */
+    OCPI_STATION_ENERGY_MIX = "ocpi_station_energy_mix",
     /** Historical average energy mix for the month. */
     GRID_MONTHLY_AVERAGE = "grid_monthly_average",
     /** Historical average energy mix for the month and hour. */
@@ -6214,6 +6253,14 @@ export declare type TotalOccupantWeightInput = {
     /** Source of inputted data, defaults to 'manual'. */
     source?: Maybe<TelemetryInputSource>;
 };
+export declare type TrafficCongestionInterval = {
+    /** Starting index of this interval in the polyline. */
+    start_index: Scalars["Int"];
+    /** Ending index of this interval in the polyline. */
+    end_index: Scalars["Int"];
+    /** Congestion level for this specific interval. */
+    level: CongestionLevel;
+};
 export declare enum TurningCircleUnit {
     /** Return the turning circle in meters. */
     METER = "meter",

package/graphql.schema.json

@@ -2195,6 +2195,41 @@
         ],
         "possibleTypes": null
       },
+      {
+        "kind": "ENUM",
+        "name": "CongestionLevel",
+        "description": null,
+        "fields": null,
+        "inputFields": null,
+        "interfaces": null,
+        "enumValues": [
+          {
+            "name": "unknown",
+            "description": "Congestion level is unknown or could not be determined.",
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "low",
+            "description": "Traffic is flowing freely with little to no delay.",
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "medium",
+            "description": "Increased traffic volume causing minor delays.",
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "high",
+            "description": "Significant traffic volume causing heavy delays and potential standstills.",
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "possibleTypes": null
+      },
       {
         "kind": "OBJECT",
         "name": "Connect",
@@ -6120,6 +6155,18 @@
             },
             "isDeprecated": false,
             "deprecationReason": null
+          },
+          {
+            "name": "traffic_aware",
+            "description": "[BETA] Indicates whether current traffic conditions were considered during route calculation. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information.",
+            "args": [],
+            "type": {
+              "kind": "SCALAR",
+              "name": "Boolean",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
           }
         ],
         "inputFields": null,
@@ -6304,6 +6351,18 @@
             "defaultValue": null,
             "isDeprecated": false,
             "deprecationReason": null
+          },
+          {
+            "name": "traffic_aware",
+            "description": "[BETA] Route should consider current traffic conditions. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information.",
+            "type": {
+              "kind": "SCALAR",
+              "name": "Boolean",
+              "ofType": null
+            },
+            "defaultValue": "false",
+            "isDeprecated": false,
+            "deprecationReason": null
           }
         ],
         "interfaces": null,
@@ -8839,7 +8898,20 @@
           {
             "name": "value",
             "description": "The base regional emissions factor in CO2e/kWh.",
-            "args": [],
+            "args": [
+              {
+                "name": "unit",
+                "description": "Emission unit.",
+                "type": {
+                  "kind": "ENUM",
+                  "name": "EmissionUnit",
+                  "ofType": null
+                },
+                "defaultValue": "gram",
+                "isDeprecated": false,
+                "deprecationReason": null
+              }
+            ],
             "type": {
               "kind": "NON_NULL",
               "name": null,
@@ -20559,6 +20631,18 @@
             },
             "isDeprecated": false,
             "deprecationReason": null
+          },
+          {
+            "name": "traffic",
+            "description": "[BETA] Information regarding traffic conditions along the route. Available for routes created with traffic_aware set.",
+            "args": [],
+            "type": {
+              "kind": "OBJECT",
+              "name": "RouteDetailsTraffic",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
           }
         ],
         "inputFields": null,
@@ -21317,6 +21401,18 @@
             },
             "isDeprecated": false,
             "deprecationReason": null
+          },
+          {
+            "name": "traffic",
+            "description": "[BETA] Information regarding traffic conditions along the route's leg . Available for routes created with traffic_aware set to true.",
+            "args": [],
+            "type": {
+              "kind": "OBJECT",
+              "name": "RouteDetailsLegTraffic",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
           }
         ],
         "inputFields": null,
@@ -21917,6 +22013,18 @@
             },
             "isDeprecated": false,
             "deprecationReason": null
+          },
+          {
+            "name": "traffic",
+            "description": "[BETA] Information regarding traffic conditions along the leg's section. Available for routes created with traffic_aware set to true.",
+            "args": [],
+            "type": {
+              "kind": "OBJECT",
+              "name": "RouteDetailsLegSectionTraffic",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
           }
         ],
         "inputFields": null,
@@ -22072,6 +22180,41 @@
         "enumValues": null,
         "possibleTypes": null
       },
+      {
+        "kind": "OBJECT",
+        "name": "RouteDetailsLegSectionTraffic",
+        "description": null,
+        "fields": [
+          {
+            "name": "congestions",
+            "description": "[BETA] Traffic congestion intervals mapped to the polyline indices of the leg's section.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "LIST",
+                "name": null,
+                "ofType": {
+                  "kind": "NON_NULL",
+                  "name": null,
+                  "ofType": {
+                    "kind": "OBJECT",
+                    "name": "TrafficCongestionInterval",
+                    "ofType": null
+                  }
+                }
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "inputFields": null,
+        "interfaces": [],
+        "enumValues": null,
+        "possibleTypes": null
+      },
       {
         "kind": "ENUM",
         "name": "RouteDetailsLegSectionType",
@@ -22156,6 +22299,41 @@
         "enumValues": null,
         "possibleTypes": null
       },
+      {
+        "kind": "OBJECT",
+        "name": "RouteDetailsLegTraffic",
+        "description": null,
+        "fields": [
+          {
+            "name": "congestions",
+            "description": "[BETA] Traffic congestion intervals mapped to the polyline indices of the leg.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "LIST",
+                "name": null,
+                "ofType": {
+                  "kind": "NON_NULL",
+                  "name": null,
+                  "ofType": {
+                    "kind": "OBJECT",
+                    "name": "TrafficCongestionInterval",
+                    "ofType": null
+                  }
+                }
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "inputFields": null,
+        "interfaces": [],
+        "enumValues": null,
+        "possibleTypes": null
+      },
       {
         "kind": "ENUM",
         "name": "RouteDetailsLegType",
@@ -22762,6 +22940,53 @@
         ],
         "possibleTypes": null
       },
+      {
+        "kind": "OBJECT",
+        "name": "RouteDetailsTraffic",
+        "description": null,
+        "fields": [
+          {
+            "name": "delay",
+            "description": "[BETA] Additional driving duration, in seconds, caused by traffic congestion compared to free-flow conditions. This value is already included in route total and driving durations.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "congestions",
+            "description": "[BETA] Traffic congestion intervals mapped to the polyline indices of the leg.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "LIST",
+                "name": null,
+                "ofType": {
+                  "kind": "OBJECT",
+                  "name": "TrafficCongestionInterval",
+                  "ofType": null
+                }
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "inputFields": null,
+        "interfaces": [],
+        "enumValues": null,
+        "possibleTypes": null
+      },
       {
         "kind": "OBJECT",
         "name": "RouteDrivingPreferences",
@@ -26057,6 +26282,12 @@
         "inputFields": null,
         "interfaces": null,
         "enumValues": [
+          {
+            "name": "ocpi_station_energy_mix",
+            "description": "The current energy mix of the charging station provided by the CPO was used.",
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
           {
             "name": "grid_monthly_average",
             "description": "Historical average energy mix for the month.",
@@ -34745,6 +34976,65 @@
         "enumValues": null,
         "possibleTypes": null
       },
+      {
+        "kind": "OBJECT",
+        "name": "TrafficCongestionInterval",
+        "description": null,
+        "fields": [
+          {
+            "name": "start_index",
+            "description": "Starting index of this interval in the polyline.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "end_index",
+            "description": "Ending index of this interval in the polyline.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "level",
+            "description": "Congestion level for this specific interval.",
+            "args": [],
+            "type": {
+              "kind": "NON_NULL",
+              "name": null,
+              "ofType": {
+                "kind": "ENUM",
+                "name": "CongestionLevel",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "inputFields": null,
+        "interfaces": [],
+        "enumValues": null,
+        "possibleTypes": null
+      },
       {
         "kind": "ENUM",
         "name": "TurningCircleUnit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chargetrip/types",
-  "version": "1.48.0",
+  "version": "1.50.0",
   "license": "MIT",
   "keywords": [
     "chargetrip",

package/src/graphql.ts

@@ -507,6 +507,17 @@ export enum ChargingBehaviourCode {
   OFFICE_CHARGING = "OFFICE_CHARGING"
 }
 
+export enum CongestionLevel {
+  /** Congestion level is unknown or could not be determined. */
+  UNKNOWN = "unknown",
+  /** Traffic is flowing freely with little to no delay. */
+  LOW = "low",
+  /** Increased traffic volume causing minor delays. */
+  MEDIUM = "medium",
+  /** Significant traffic volume causing heavy delays and potential standstills. */
+  HIGH = "high"
+}
+
 export type Connect = {
   /** List of connectivity providers to which the vehicle can connect. This field returns null for free users. Please contact customer success for more information. */
   providers?: Maybe<Array<ConnectProvider>>;
@@ -1280,6 +1291,8 @@ export type CreateRoute = {
   weather?: Maybe<RouteWeather>;
   /** Charging stations preferences for route calculation. */
   station_preferences?: Maybe<RouteStationPreferences>;
+  /** [BETA] Indicates whether current traffic conditions were considered during route calculation. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information. */
+  traffic_aware?: Maybe<Scalars["Boolean"]>;
 };
 
 /** Input for the create route mutation. */
@@ -1308,6 +1321,8 @@ export type CreateRouteInput = {
   station_preferences?: Maybe<RouteStationPreferencesInput>;
   /** [BETA] Configuration options for the route's driving conditions. Includes factors to adjust average speed, set a maximum speed, and define a base driving style. If not specified, no adjustments are applied. */
   driving_preferences?: Maybe<RouteDrivingPreferencesInput>;
+  /** [BETA] Route should consider current traffic conditions. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information. */
+  traffic_aware?: Maybe<Scalars["Boolean"]>;
 };
 
 /** Currency in the ISO 4217 format. */
@@ -1763,6 +1778,10 @@ export type EmissionsFactor = {
   value: Scalars["Float"];
 };
 
+export type EmissionsFactorvalueArgs = {
+  unit?: Maybe<EmissionUnit>;
+};
+
 /** Emissions factor type. */
 export enum EmissionsFactorType {
   COUNTRY = "country",
@@ -4097,6 +4116,8 @@ export type RouteDetails = {
   charges: Scalars["Int"];
   /** [BETA] Warnings that certain conditions specified in a route mutation are not respected. */
   warnings?: Maybe<Array<RouteWarning>>;
+  /** [BETA] Information regarding traffic conditions along the route. Available for routes created with traffic_aware set. */
+  traffic?: Maybe<RouteDetailsTraffic>;
 };
 
 export type RouteDetailsdistanceArgs = {
@@ -4221,6 +4242,8 @@ export type RouteDetailsLeg = {
   sections: Array<RouteDetailsLegSection>;
   /** [BETA] Warnings that certain conditions specified in a route mutation are not respected. */
   warnings?: Maybe<Array<RouteDetailsLegWarning>>;
+  /** [BETA] Information regarding traffic conditions along the route's leg . Available for routes created with traffic_aware set to true. */
+  traffic?: Maybe<RouteDetailsLegTraffic>;
 };
 
 /** Leg of a route detail. */
@@ -4347,6 +4370,8 @@ export type RouteDetailsLegSection = {
   duration: Scalars["Float"];
   /** Total energy used in a section in kilowatt-hours. The value will be 0 for walking sections. */
   consumption?: Maybe<Scalars["Float"]>;
+  /** [BETA] Information regarding traffic conditions along the leg's section. Available for routes created with traffic_aware set to true. */
+  traffic?: Maybe<RouteDetailsLegSectionTraffic>;
 };
 
 export type RouteDetailsLegSectionpolylineArgs = {
@@ -4385,6 +4410,11 @@ export type RouteDetailsLegSectionFeaturePointPropertiestotal_cargo_weightArgs =
   unit?: Maybe<WeightUnit>;
 };
 
+export type RouteDetailsLegSectionTraffic = {
+  /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg's section. */
+  congestions: Array<TrafficCongestionInterval>;
+};
+
 /** Type of a route details leg section. */
 export enum RouteDetailsLegSectionType {
   DRIVING = "driving",
@@ -4401,6 +4431,11 @@ export type RouteDetailsLegStation = {
   connector_id: Scalars["ID"];
 };
 
+export type RouteDetailsLegTraffic = {
+  /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg. */
+  congestions: Array<TrafficCongestionInterval>;
+};
+
 /** Type of a leg. */
 export enum RouteDetailsLegType {
   /** This leg ends at a charging station and the vehicle must recharge. */
@@ -4538,6 +4573,13 @@ export enum RouteDetailsTag {
   CROSSBORDER = "crossborder"
 }
 
+export type RouteDetailsTraffic = {
+  /** [BETA] Additional driving duration, in seconds, caused by traffic congestion compared to free-flow conditions. This value is already included in route total and driving durations. */
+  delay: Scalars["Int"];
+  /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg. */
+  congestions: Array<Maybe<TrafficCongestionInterval>>;
+};
+
 export type RouteDrivingPreferences = {
   /** [BETA] Factor to adjust the route's calculated average speed. Accepts values between 0.80 and 1.20. 1.0 is neutral. Values below 1.0 reduce speed (e.g. 0.95 is -5%), values above increase it. If provided in combination with style, this overrides the speed factor implied by the selected 'style'. */
   speed_factor?: Maybe<Scalars["Float"]>;
@@ -5172,6 +5214,8 @@ export type RouteOperationalElectricityEmissionsIntensityinfrastructureArgs = {
 
 /** Energy source models. */
 export enum RouteOperationalElectricityEnergySourceModel {
+  /** The current energy mix of the charging station provided by the CPO was used. */
+  OCPI_STATION_ENERGY_MIX = "ocpi_station_energy_mix",
   /** Historical average energy mix for the month. */
   GRID_MONTHLY_AVERAGE = "grid_monthly_average",
   /** Historical average energy mix for the month and hour. */
@@ -6796,6 +6840,15 @@ export type TotalOccupantWeightInput = {
   source?: Maybe<TelemetryInputSource>;
 };
 
+export type TrafficCongestionInterval = {
+  /** Starting index of this interval in the polyline. */
+  start_index: Scalars["Int"];
+  /** Ending index of this interval in the polyline. */
+  end_index: Scalars["Int"];
+  /** Congestion level for this specific interval. */
+  level: CongestionLevel;
+};
+
 export enum TurningCircleUnit {
   /** Return the turning circle in meters. */
   METER = "meter",