{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"🚧 Building a Routing Request","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"-building-a-routing-request","__idx":0},"children":["🚧 Building a Routing Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section guides you through the steps to construct a complete request for the routing API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each request is composed of multiple blocks, each defining a key aspect of the route calculation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-basic-structure","__idx":1},"children":["🧱 Basic Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A standard request is a JSON object that includes at minimum:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [ ... ],\n  \"routingVehicleProfile\": { ... }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"️-1-destinations","__idx":2},"children":["🗺️ 1. destinations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List of GPS coordinates (latitude / longitude) forming the route."," ","The first point is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["starting point"]},", the last one is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["destination"]},", and any others are intermediate waypoints."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 2.38261,\n        \"lat\": 48.85356\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 4.35631,\n        \"lat\": 50.84531\n      }\n    }\n  ]\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-2-routingvehicleprofile","__idx":3},"children":["🚗 2. routingVehicleProfile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Defines the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["vehicle type"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transport mode"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["physical or legal characteristics"]}," used during routing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This includes parameters like height, width, length, weight, and axle weight in centimeters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": \"190\",\n      \"width\": \"230\",\n      \"length\": \"1875\",\n      \"weight\": \"35\",\n      \"axleWeight\": \"10\"\n    }\n  }\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-3-routingcriterias-optional","__idx":4},"children":["🧭 3. routingCriterias (optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Specifies route preferences such as avoiding tolls, ferries, or motorways."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"routingCriterias\": [\"AVOID_TOLLS\", \"AVOID_FERRIES\"]\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"️-4-options-optional","__idx":5},"children":["⚙️ 4. options (optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enables additional output features such as polyline geometry."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"options\": [\"POLYLINE\"]\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-full-example","__idx":6},"children":["🔁 Full Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 2.38261,\n        \"lat\": 48.85356\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 4.35631,\n        \"lat\": 50.84531\n      }\n    }\n  ],\n  \"options\": [\n    \"POLYLINE\"\n  ],\n  \"routingCriterias\": [\n    \"AVOID_FERRIES\",\n    \"AVOID_TOLLS\"\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": \"190\",\n      \"width\": \"230\",\n      \"length\": \"1875\",\n      \"weight\": \"35\",\n      \"axleWeight\": \"10\"\n    }\n  }\n}\n"},"children":[]}]},"headings":[{"value":"🚧 Building a Routing Request","id":"-building-a-routing-request","depth":1},{"value":"🧱 Basic Structure","id":"-basic-structure","depth":2},{"value":"🗺️ 1. destinations","id":"️-1-destinations","depth":3},{"value":"🚗 2. routingVehicleProfile","id":"-2-routingvehicleprofile","depth":3},{"value":"🧭 3. routingCriterias (optional)","id":"-3-routingcriterias-optional","depth":3},{"value":"⚙️ 4. options (optional)","id":"️-4-options-optional","depth":3},{"value":"🔁 Full Example","id":"-full-example","depth":3}],"frontmatter":{"seo":{"title":"🚧 Building a Routing Request"}},"lastModified":"2025-08-26T09:03:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/routing/tutorial/routing_1introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}