{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"🧪 Routing Mode 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_mode_tutorial"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"-routing-mode-tutorial","__idx":0},"children":["🧪 Routing Mode Tutorial"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial provides clear usage examples for each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingMode"]}," supported by the routing API. Each example includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["✅ A practical use case"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["📦 A ready-to-use JSON payload"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["💡 An explanation of what the request does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🔧 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to enable routing criteria"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To define the routing mode, simply include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingMode"]}," field in your routing request JSON. Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingMode\": \"MODE_VIAS\"\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"mode_vias"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-mode_vias--standard-route-with-waypoints","__idx":1},"children":["📍 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODE_VIAS"]}," – Standard route with waypoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Compute a standard route from point A to B to C, following the given order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📦 Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_VIAS\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.81594, \"lat\": 45.75508 } },\n    { \"coordinateSat\": { \"lon\": 5.04476, \"lat\": 47.33372 } },\n    { \"coordinateSat\": { \"lon\": 2.34241, \"lat\": 48.85223 } }\n  ],\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Calculates a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single route"]}," from Lyon → Dijon → Paris, in the exact order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\n{\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\": 5.044754103431373,\n        \"lat\": 47.33364875\n      },\n      \"confidenceValue\": 0.3017814726840855,\n      \"distanceFromRequest\": 7.94,\n      \"polylineIndex\": -1,\n      \"duration\": 7202,\n      \"length\": 195778\n    },\n    {\n      \"inputOrder\": 2,\n      \"used\": true,\n      \"usedOrder\": 2,\n      \"matchedCoordinateGps\": {\n        \"lon\": 2.3423590873895535,\n        \"lat\": 48.85218\n      },\n      \"confidenceValue\": 0.16602793114647615,\n      \"distanceFromRequest\": 6.7,\n      \"polylineIndex\": -1,\n      \"duration\": 18933,\n      \"length\": 510058\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 510058,\n      \"duration\": 18933,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 96.984566,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"boundingBox\": {\n        \"minLon\": 2.30612,\n        \"minLat\": 45.7515,\n        \"maxLon\": 5.08011,\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":"mode_1_to_n"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-mode_1_to_n--one-origin-to-many-destinations","__idx":2},"children":["🧭 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODE_1_TO_N"]}," – One origin to many destinations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Compute separate routes from a single starting point to multiple destinations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📦 Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_1_TO_N\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } },  \n    { \"coordinateSat\": { \"lon\": 5.3698, \"lat\": 43.2965 } },\n    { \"coordinateSat\": { \"lon\": 7.2619, \"lat\": 43.7102 } },\n    { \"coordinateSat\": { \"lon\": 2.3522, \"lat\": 48.8566 } }\n  ],\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["individual routes"]}," from Lyon to each destination:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["📨 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lyon → Marseille"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lyon → Nice"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lyon → Paris"]}]},{"$$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\": 5.37028,\n        \"lat\": 43.29654\n      },\n      \"confidenceValue\": 0.4295641187618445,\n      \"distanceFromRequest\": 39.14,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 2,\n      \"used\": true,\n      \"usedOrder\": 2,\n      \"matchedCoordinateGps\": {\n        \"lon\": 7.2619026033410385,\n        \"lat\": 43.7101925\n      },\n      \"confidenceValue\": 0.188395259216171,\n      \"distanceFromRequest\": 0.83,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 3,\n      \"used\": true,\n      \"usedOrder\": 3,\n      \"matchedCoordinateGps\": {\n        \"lon\": 2.3525263882048697,\n        \"lat\": 48.85722125\n      },\n      \"confidenceValue\": 0.007055115402485117,\n      \"distanceFromRequest\": 73.17,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 314264,\n      \"duration\": 11317,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 99.96911,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"boundingBox\": {\n        \"minLon\": 4.70685,\n        \"minLat\": 43.29515,\n        \"maxLon\": 5.37173,\n        \"maxLat\": 45.76617\n      },\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        \"stop\": {\n          \"lon\": 5.37028,\n          \"lat\": 43.29654\n        },\n        \"distanceFirstMatched\": 0,\n        \"distanceLastMatched\": 0,\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":"mode_n_to_1"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-mode_n_to_1--many-origins-to-one-destination","__idx":3},"children":["🧭 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODE_N_TO_1"]}," – Many origins to one destination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Calculate independent routes from multiple origins to a single destination."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📦 Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_N_TO_1\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } },\n    { \"coordinateSat\": { \"lon\": 6.1294, \"lat\": 46.2044 } },\n    { \"coordinateSat\": { \"lon\": 5.7224, \"lat\": 45.1885 } },\n    { \"coordinateSat\": { \"lon\": 5.0415, \"lat\": 47.3220 } }\n  ],\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns routes from Lyon, Annecy, and Grenoble ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["to Dijon"]}," (last point is the destination)."]},{"$$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\": 6.12971,\n        \"lat\": 46.20452\n      },\n      \"confidenceValue\": 0.8268272425249169,\n      \"distanceFromRequest\": 27.37,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 2,\n      \"used\": true,\n      \"usedOrder\": 2,\n      \"matchedCoordinateGps\": {\n        \"lon\": 5.722293645827602,\n        \"lat\": 45.18855125\n      },\n      \"confidenceValue\": 0.7293058379320361,\n      \"distanceFromRequest\": 10.11,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 3,\n      \"used\": true,\n      \"usedOrder\": 3,\n      \"matchedCoordinateGps\": {\n        \"lon\": 5.0419,\n        \"lat\": 47.32316\n      },\n      \"confidenceValue\": 0.011090957769868685,\n      \"distanceFromRequest\": 132.61,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 196040,\n      \"duration\": 7554,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 93.42653,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"boundingBox\": {\n        \"minLon\": 4.71619,\n        \"minLat\": 45.75105,\n        \"maxLon\": 5.08011,\n        \"maxLat\": 47.32631\n      },\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        \"stop\": {\n          \"lon\": 5.0419,\n          \"lat\": 47.32316\n        },\n        \"distanceFirstMatched\": 0,\n        \"distanceLastMatched\": 0,\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":"mode_n_to_n"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-mode_n_to_n--full-nxn-route-matrix","__idx":4},"children":["🧭 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODE_N_TO_N"]}," – Full NxN route matrix"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Compute all possible routes between each pair of N locations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📦 Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_N_TO_N\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.83554, \"lat\": 45.76412 } },\n    { \"coordinateSat\": { \"lon\": 5.37028, \"lat\": 43.29654 } },\n    { \"coordinateSat\": { \"lon\": 1.48529, \"lat\": 43.63876 } },\n    { \"coordinateSat\": { \"lon\": 2.34212, \"lat\": 48.82982 } }\n  ],\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["16 route combinations"]}," (4x4), including every possible origin/destination pair."]},{"$$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.3741339491916859,\n      \"distanceFromRequest\": 0,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 5.37028,\n        \"lat\": 43.29654\n      },\n      \"confidenceValue\": 0.20007719027402546,\n      \"distanceFromRequest\": 0,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 2,\n      \"used\": true,\n      \"usedOrder\": 2,\n      \"matchedCoordinateGps\": {\n        \"lon\": 1.4852923354376975,\n        \"lat\": 43.638755\n      },\n      \"confidenceValue\": 0.2616331886544867,\n      \"distanceFromRequest\": 0.56,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 3,\n      \"used\": true,\n      \"usedOrder\": 3,\n      \"matchedCoordinateGps\": {\n        \"lon\": 2.34205,\n        \"lat\": 48.83009\n      },\n      \"confidenceValue\": 1,\n      \"distanceFromRequest\": 30.49,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 314264,\n      \"duration\": 11317,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 99.96911,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 3000,\n      \"boundingBox\": {\n        \"minLon\": 4.70685,\n        \"minLat\": 43.29515,\n        \"maxLon\": 5.37173,\n        \"maxLat\": 45.76617\n      },\n      \"startStopInfo\": {\n        \"start\": {\n          \"lon\": 4.83554,\n          \"lat\": 45.76412\n        },\n        \"stop\": {\n          \"lon\": 5.37028,\n          \"lat\": 43.29654\n        },\n        \"distanceFirstMatched\": 0,\n        \"distanceLastMatched\": 0,\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":"mode_matrix"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-mode_matrix--distance--time--energy-matrix","__idx":5},"children":["🧮 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODE_MATRIX"]}," – Distance / time / energy matrix"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["matrix"]}," of distances, travel times or energy consumption between multiple origins and destinations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📦 Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_MATRIX\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.83554, \"lat\": 45.76412 } },\n    { \"coordinateSat\": { \"lon\": 5.6943, \"lat\": 45.18019 } },\n    { \"coordinateSat\": { \"lon\": 5.40638, \"lat\": 43.32238 } },\n    { \"coordinateSat\": { \"lon\": 1.45128, \"lat\": 43.61487 } }\n  ],\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns a table (matrix) with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["distance/time/energy values"]}," between each pair of points. No route geometry is included."]},{"$$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.3741339491916859,\n      \"distanceFromRequest\": 0,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 1,\n      \"used\": true,\n      \"usedOrder\": 1,\n      \"matchedCoordinateGps\": {\n        \"lon\": 5.694295961447033,\n        \"lat\": 45.18018875\n      },\n      \"confidenceValue\": 0.06747539959389807,\n      \"distanceFromRequest\": 0.14,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 2,\n      \"used\": true,\n      \"usedOrder\": 2,\n      \"matchedCoordinateGps\": {\n        \"lon\": 5.4063817189367205,\n        \"lat\": 43.32238125\n      },\n      \"confidenceValue\": 0.16168673195683364,\n      \"distanceFromRequest\": 0.14,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    },\n    {\n      \"inputOrder\": 3,\n      \"used\": true,\n      \"usedOrder\": 3,\n      \"matchedCoordinateGps\": {\n        \"lon\": 1.4512833045462004,\n        \"lat\": 43.6148675\n      },\n      \"confidenceValue\": 0.1723633461896529,\n      \"distanceFromRequest\": 0.28,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": -1,\n      \"duration\": 0,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 0,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 0,\n      \"energyConsumption\": -1\n    },\n    {\n      \"length\": -1,\n      \"duration\": 4723,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 0,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 0,\n      \"energyConsumption\": -1\n    },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"mode_isochrone"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-mode_isochrone--reachable-area","__idx":6},"children":["🗺️ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODE_ISOCHRONE"]}," – Reachable area"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["✅ Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Visualize the area reachable within a given ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["distance"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["energy"]}," limit."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📍 Example: From one point (Lyon)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_ISOCHRONE\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } }\n  ],\n  \"isoChroneLimit\": 1800,\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns the polygon representing the zone reachable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["within 30 minutes"]}," from Lyon."]},{"$$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  \"routingRoutes\": [\n    {\n      \"length\": 0,\n      \"duration\": 0,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 0,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 0,\n      \"boundingBox\": {\n        \"minLon\": 4.56677,\n        \"minLat\": 45.5055,\n        \"maxLon\": 5.19823,\n        \"maxLat\": 46.00572\n      },\n      \"polyline\": [\n        {\n          \"lon\": 4.96174,\n          \"lat\": 45.87819\n        },\n        {\n          \"lon\": 4.96793,\n          \"lat\": 45.88438\n        },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["📍 Example: From two points with energy constraint"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingMode\": \"MODE_ISOCHRONE\",\n  \"destinations\": [\n    { \"coordinateSat\": { \"lon\": 4.8357, \"lat\": 45.7640 } },\n    { \"coordinateSat\": { \"lon\": 4.9000, \"lat\": 45.5600 } }\n  ],\n  \"isoChroneLimit\": 3000,\n  \"options\": [\"POLYLINE\"],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\"\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns the area reachable from Lyon to Valence using ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3000 Wh"]}," of energy. Useful for EV range visualization."]},{"$$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.89971,\n        \"lat\": 45.55845\n      },\n      \"confidenceValue\": 0.2467450352129857,\n      \"distanceFromRequest\": 174.02,\n      \"polylineIndex\": -1,\n      \"duration\": -1,\n      \"length\": -1\n    }\n  ],\n  \"routingRoutes\": [\n    {\n      \"length\": 0,\n      \"duration\": 0,\n      \"trafficDelay\": 0,\n      \"averageSpeed\": 0,\n      \"maximumSpeed\": 0,\n      \"startUTurnThreshold\": 0,\n      \"boundingBox\": {\n        \"minLon\": 4.73271,\n        \"minLat\": 45.50303,\n        \"maxLon\": 4.92389,\n        \"maxLat\": 45.78482\n      },\n      \"polyline\": [\n        {\n          \"lon\": 4.81835,\n          \"lat\": 45.63508\n        },\n        {\n          \"lon\": 4.82443,\n          \"lat\": 45.64226\n        },\n"},"children":[]}]},"headings":[{"value":"🧪 Routing Mode Tutorial","id":"-routing-mode-tutorial","depth":1},{"value":"📍 MODE_VIAS – Standard route with waypoints","id":"-mode_vias--standard-route-with-waypoints","depth":2},{"value":"🧭 MODE_1_TO_N – One origin to many destinations","id":"-mode_1_to_n--one-origin-to-many-destinations","depth":2},{"value":"🧭 MODE_N_TO_1 – Many origins to one destination","id":"-mode_n_to_1--many-origins-to-one-destination","depth":2},{"value":"🧭 MODE_N_TO_N – Full NxN route matrix","id":"-mode_n_to_n--full-nxn-route-matrix","depth":2},{"value":"🧮 MODE_MATRIX – Distance / time / energy matrix","id":"-mode_matrix--distance--time--energy-matrix","depth":2},{"value":"🗺️ MODE_ISOCHRONE – Reachable area","id":"️-mode_isochrone--reachable-area","depth":2}],"frontmatter":{"seo":{"title":"🧪 Routing Mode Tutorial"}},"lastModified":"2025-08-26T09:03:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/routing/tutorial/routing_mode","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}