{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"🚗 Routing Vehicle Profile Tutorial","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"routing_vehicle_profile_tutorial"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"-routing-vehicle-profile-tutorial","__idx":0},"children":["🚗 Routing Vehicle Profile Tutorial"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial explains how to configure and use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]}," field in your routing requests.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"A vehicle profile allows the routing engine to account for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["physical"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["legal"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["toll"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["energy-related"]}," characteristics of your vehicle, leading to more accurate results."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-how-to-enable-routingvehicleprofile","__idx":1},"children":["🔧 How to enable routingVehicleProfile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Simply add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]}," field to your JSON request body.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"It must follow the structure of a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/routing/routing#routingvehicleprof"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RoutingVehicleProf"]}]}," object:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"routingVehicleProfile\": {\n  \"transportMode\": \"CAR\",\n  \"routingVehicleFeature\": {\n    \"maxSpeed\": 90,\n    \"vehicleWeight\": 1500,\n    \"emissionClass\": \"EURO6\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can combine this with other options such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVENT"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OPTIMIZED_ROUTE_FOR_CHARGING_STATION"]}," to get detailed segment info or compute energy-based routes."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-why-use-a-vehicle-profile","__idx":2},"children":["🔍 Why use a vehicle profile?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]}," allows you to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Respect legal constraints (e.g. max height, weight limits)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optimize EV routes based on consumption models"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid restricted roads (e.g. tunnels, bridges, zones)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Get realistic ETA and energy consumption estimates"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"routing_max_speeds"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-maxspeeds--define-vehicle-speed-limits","__idx":3},"children":["🚦 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxSpeeds"]}," – Define vehicle speed limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set custom maximum speeds for the vehicle to influence both ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["route calculation"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["estimated time of arrival (ETA)"]}," independently."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Allows you to define speed constraints for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only the route computation (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAL"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only the ETA computation (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ETA"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Or both (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ALL"]},", default)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is useful when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your vehicle drives slower than allowed (e.g. heavy truck)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want to test a route with lower speeds for simulations"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🔧 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to enable"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxSpeeds"]}," field inside your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingVehicleProfile\": {\n  \"transportMode\": \"CAR\",\n  \"maxSpeeds\": [\n    { \"type\": \"ALL\", \"value\": 90 }\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📦 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } },\n    { \"coordinateSat\": { \"lon\": 4.8270, \"lat\": 45.7580 } }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"TRUCK\",\n    \"routingVehicleFeature\": {\n      \"maxSpeeds\": [\n        { \"type\": \"CAL\", \"value\": 80 },\n        { \"type\": \"ETA\", \"value\": 90 }\n      ]\n    }\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"usedDestinations\": [\n    {\n      \"inputOrder\": 0,\n      \"used\": true,\n      \"usedOrder\": 0,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.835805567159972,\n        \"lat\": 45.7639975\n      },\n      \"confidenceValue\": 0.11463414634146339,\n      \"distanceFromRequest\": 8.2,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.826438509920649,\n        \"lat\": 45.7582675\n      },\n      \"confidenceValue\": 0.9746478873239437,\n      \"distanceFromRequest\": 52.81,\n      \"polylineIndex\": -1,\n      \"duration\": 573,\n      \"length\": 3648\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 3648,\n      \"duration\": 573,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 22.919373,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83581,\n          \"lat\": 45.764\n        },\n        \"stop\": {\n          \"lon\": 4.82644,\n          \"lat\": 45.75827\n        },\n        \"distanceFirstMatched\": 0.28,\n        \"distanceLastMatched\": 0.28,\n        \"interDests\": null\n      }\n    }\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"routing_energy_vehicle_feature_tutorial"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-routingenergyvehiclefeature--energy-consumption-parameters","__idx":4},"children":["⚡ routingEnergyVehicleFeature – Energy Consumption Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enable energy consumption estimation and EV-specific routing by defining physical, environmental, and battery-related parameters of the vehicle."," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provides detailed energy profile for the vehicle to allow:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Estimating battery usage during routing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Predicting recharging needs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Applying realistic physical constraints (mass, aerodynamism, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Simulating driving behaviors and conditions (temperature, payload, regen braking...)"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["🔧 How to enable"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must include a routingVehicleProfile in your routing request and nest routingEnergyVehicleFeature inside it:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingVehicleProfile\": {\n  \"transportMode\": \"CAR\",\n  \"routingEnergyVehicleFeature\": {\n    \"auxConsumption\": 1000,\n    \"batCapacity\": 60.0,\n    \"crr\": 0.01,\n    \"dryWeight\": 1600,\n    \"energyLoad\": 45.0,\n    \"engineEfficiency\": 0.9,\n    \"extTemp\": 20.5,\n    \"maxAccel\": 2.5,\n    \"maxChargePower\": 7.2,\n    \"maxChargePowerAc3\": 11.0,\n    \"maxChargePowerDc\": 50.0,\n    \"maxDecel\": -3.0,\n    \"payload\": 200,\n    \"regenerativeBraking\": true,\n    \"scx\": 0.7\n    }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"usedDestinations\": [\n    {\n      \"inputOrder\": 0,\n      \"used\": true,\n      \"usedOrder\": 0,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.83554,\n        \"lat\": 45.76412\n      },\n      \"confidenceValue\": 0.33438985736925514,\n      \"distanceFromRequest\": 18.24,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.826438509920649,\n        \"lat\": 45.7582675\n      },\n      \"confidenceValue\": 0.9746478873239437,\n      \"distanceFromRequest\": 52.81,\n      \"polylineIndex\": -1,\n      \"duration\": 486,\n      \"length\": 1830\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 1830,\n      \"duration\": 486,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 13.555555,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"energyConsumption\": 0.4836538185808414,\n      \"boundingBox\": {\n        \"minLon\": 4.82545,\n        \"minLat\": 45.7578,\n        \"maxLon\": 4.83554,\n        \"maxLat\": 45.76528\n      },\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        \"stop\": {\n          \"lon\": 4.82644,\n          \"lat\": 45.75827\n        },\n        \"distanceFirstMatched\": 0,\n        \"distanceLastMatched\": 0.28,\n        \"interDests\": null\n      },\n      \"polyline\": [\n        {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        {\n          \"lon\": 4.83422,\n          \"lat\": 45.76421\n        },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"routing_speed_ponderation_tutorial"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-routingspeedponderations--adjust-speed-by-road-type-or-level","__idx":5},"children":["🏁 routingSpeedPonderations – Adjust speed by road type or level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customize your vehicle's speed based on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["road type"]}," (e.g. motorway, urban, roundabout) and road level (main, secondary, etc.)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applies a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["speed coefficient"]}," to influence the vehicle’s behavior depending on the road characteristics."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this to simulate:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Slower driving in cities or roundabouts"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Faster driving on motorways"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Realistic speed profiles based on actual driving patterns"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🔧 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to enable"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingSpeedPonderations"]}," field to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingVehicleProfile\": {\n  \"transportMode\": \"CAR\",\n  \"routingSpeedPonderations\": [\n    {\n      \"factor\": 0.8,\n      \"level\": 4,\n      \"pondType\": \"ETA\",\n      \"roadType\": \"ROUNDABOUNT\"\n    },\n    {\n      \"factor\": 1.2,\n      \"level\": 1,\n      \"pondType\": \"CAL\",\n      \"roadType\": \"MOTORWAY\"\n    }\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📦 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } },\n    { \"coordinateSat\": { \"lon\": 4.8270, \"lat\": 45.7580 } }\n  ],\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingSpeedPonderations\": [\n      {\n        \"factor\": 0.8,\n        \"level\": 4,\n        \"pondType\": \"ETA\",\n        \"roadType\": \"ROUNDABOUNT\"\n      },\n      {\n        \"factor\": 1.2,\n        \"level\": 1,\n        \"pondType\": \"CAL\",\n        \"roadType\": \"MOTORWAY\"\n      }\n    ]\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"usedDestinations\": [\n    {\n      \"inputOrder\": 0,\n      \"used\": true,\n      \"usedOrder\": 0,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.83554,\n        \"lat\": 45.76412\n      },\n      \"confidenceValue\": 0.33438985736925514,\n      \"distanceFromRequest\": 18.24,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.826438509920649,\n        \"lat\": 45.7582675\n      },\n      \"confidenceValue\": 0.9746478873239437,\n      \"distanceFromRequest\": 52.81,\n      \"polylineIndex\": -1,\n      \"duration\": 486,\n      \"length\": 1830\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 1830,\n      \"duration\": 486,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 13.555555,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"boundingBox\": {\n        \"minLon\": 4.82545,\n        \"minLat\": 45.7578,\n        \"maxLon\": 4.83554,\n        \"maxLat\": 45.76528\n      },\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        \"stop\": {\n          \"lon\": 4.82644,\n          \"lat\": 45.75827\n        },\n        \"distanceFirstMatched\": 0,\n        \"distanceLastMatched\": 0.28,\n        \"interDests\": null\n      },\n      \"polyline\": [\n        {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        {\n          \"lon\": 4.83422,\n          \"lat\": 45.76421\n        },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"routing_vehicle_feature_tutorial"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-routingvehiclefeature--define-vehicle-characteristics","__idx":6},"children":["🚚 routingVehicleFeature – Define vehicle characteristics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A routing vehicle feature defines ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["physical, legal, and toll characteristics"]},". These parameters directly affect the routing result based on map constraints, such as bridge heights, weight limits, hazardous materials, and toll pricing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Route a truck carrying hazardous material through allowed tunnels only"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid bridges with low clearance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply proper toll cost for commercial vehicles"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each field in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleFeature"]}," corresponds to a real-world constraint:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Physical limits: height, width, length, axleWeight, etc."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Legal limits: nbTrailer, hazardous materials, ADR category"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Toll impact: emission class, vehicle type, number of axles, hybrid, HOV, etc."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🔧 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to enable"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleFeature"]}," block to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]}," in your routing request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingVehicleProfile\": {\n  \"transportMode\": \"TRUCK\",\n  \"routingVehicleFeature\": {\n    \"height\": 400,\n    \"weight\": 35,\n    \"hazardousMaterials\": \"EXPLOSIVE\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📦 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.81594, \"lat\": 45.75508 } },\n    { \"coordinateSat\": { \"lon\": 2.34241, \"lat\": 48.85223 } }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"TRUCK\",\n    \"routingVehicleFeature\": {\n      \"adrTunnelCategory\": \"CAT_C\",\n      \"axleWeight\": 12,\n      \"caravan\": \"NO\",\n      \"cial\": \"YES\",\n      \"disEquipped\": \"NO\",\n      \"emissionClass\": \"EURO6\",\n      \"hazardousMaterials\": \"EXPLOSIVE\",\n      \"height\": 420,\n      \"hov\": \"NO\",\n      \"hybrid\": \"NO\",\n      \"length\": 1800,\n      \"nbPassengers\": 1,\n      \"nbTires\": 6,\n      \"nbTrailAxles\": 2,\n      \"nbTrailer\": 1,\n      \"nbVehAxles\": 2,\n      \"onlyPhysical\": false,\n      \"pollMin\": \"NO\",\n      \"tollTransportCategory\": \"TRUCK\",\n      \"trailHeight\": 220,\n      \"vehHeight\": 200,\n      \"vehWeight\": 25,\n      \"weight\": 35,\n      \"width\": 250\n    }\n  },\n  \"options\": [ \"POLYLINE\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"usedDestinations\": [\n    {\n      \"inputOrder\": 0,\n      \"used\": true,\n      \"usedOrder\": 0,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.815940190524969,\n        \"lat\": 45.75508125\n      },\n      \"confidenceValue\": 0.3742419867167196,\n      \"distanceFromRequest\": 0.14,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 2.3423590873895535,\n        \"lat\": 48.85218\n      },\n      \"confidenceValue\": 0.16602793114647615,\n      \"distanceFromRequest\": 6.7,\n      \"polylineIndex\": -1,\n      \"duration\": 17239,\n      \"length\": 461562\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 461562,\n      \"duration\": 17239,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 96.38744,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"boundingBox\": {\n        \"minLon\": 2.30612,\n        \"minLat\": 45.75484,\n        \"maxLon\": 4.9201,\n        \"maxLat\": 48.85218\n      },\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.81594,\n          \"lat\": 45.75508\n        },\n        \"stop\": {\n          \"lon\": 2.34236,\n          \"lat\": 48.85218\n        },\n        \"distanceFirstMatched\": 0.14,\n        \"distanceLastMatched\": 0,\n        \"interDests\": null\n      },\n      \"polyline\": [\n        {\n          \"lon\": 4.815940190524969,\n          \"lat\": 45.75508125\n        },\n        {\n          \"lon\": 4.81627,\n          \"lat\": 45.75484\n        },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"routing_transport_mode"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-transportmode--define-the-transportation-mode","__idx":7},"children":["🚗 transportMode – Define the transportation mode"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Specify the transportation mode (car, pedestrian, truck, etc.) to adapt the route calculation to legal access, traffic rules, and restrictions relevant to the vehicle."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The transportation mode affects:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to certain roads (e.g., pedestrian-only streets)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Turn restrictions and traffic directions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Applicable traffic data (e.g., emergency vs public transport)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If omitted, the default mode is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAR"]}," (for standard routing)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EMERGENCY"]}," (for Traceroute service)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🔧 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to enable"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the transportMode field in your routingVehicleProfile object:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingVehicleProfile\": {\n  \"transportMode\": \"TRUCK\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📦 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } },\n    { \"coordinateSat\": { \"lon\": 4.8270, \"lat\": 45.7580 } }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"PEDESTRIAN\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"usedDestinations\": [\n    {\n      \"inputOrder\": 0,\n      \"used\": true,\n      \"usedOrder\": 0,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.835805567159972,\n        \"lat\": 45.7639975\n      },\n      \"confidenceValue\": 0.10741947771617216,\n      \"distanceFromRequest\": 8.2,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 4.826438509920649,\n        \"lat\": 45.7582675\n      },\n      \"confidenceValue\": 0.9746478873239437,\n      \"distanceFromRequest\": 52.81,\n      \"polylineIndex\": -1,\n      \"duration\": 1126,\n      \"length\": 1194\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 1194,\n      \"duration\": 1126,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 3.8174067,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83581,\n          \"lat\": 45.764\n        },\n        \"stop\": {\n          \"lon\": 4.82644,\n          \"lat\": 45.75827\n        },\n        \"distanceFirstMatched\": 0.28,\n        \"distanceLastMatched\": 0.28,\n        \"interDests\": null\n      }\n    }\n  ]\n}\n"},"children":[]}]},"headings":[{"value":"🚗 Routing Vehicle Profile Tutorial","id":"-routing-vehicle-profile-tutorial","depth":1},{"value":"🔧 How to enable routingVehicleProfile","id":"-how-to-enable-routingvehicleprofile","depth":2},{"value":"🔍 Why use a vehicle profile?","id":"-why-use-a-vehicle-profile","depth":2},{"value":"🚦 maxSpeeds – Define vehicle speed limits","id":"-maxspeeds--define-vehicle-speed-limits","depth":2},{"value":"⚡ routingEnergyVehicleFeature – Energy Consumption Parameters","id":"-routingenergyvehiclefeature--energy-consumption-parameters","depth":2},{"value":"🏁 routingSpeedPonderations – Adjust speed by road type or level","id":"-routingspeedponderations--adjust-speed-by-road-type-or-level","depth":2},{"value":"🚚 routingVehicleFeature – Define vehicle characteristics","id":"-routingvehiclefeature--define-vehicle-characteristics","depth":2},{"value":"🚗 transportMode – Define the transportation mode","id":"-transportmode--define-the-transportation-mode","depth":2}],"frontmatter":{"seo":{"title":"🚗 Routing Vehicle Profile Tutorial"}},"lastModified":"2025-08-26T09:03:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/routing/tutorial/routing_vehicleprofile","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}