{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"πŸ›°οΈ Routing Event 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_event_tutorial"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"️-routing-event-tutorial","__idx":0},"children":["πŸ›°οΈ Routing Event Tutorial"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial explains how to use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVENT"]}," option in routing requests to retrieve ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["detailed segment-level data"]}," such as elevation, traffic, duration, and more."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each section includes a use case, a description of the expected result, and a practical JSON example."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-how-to-enable-events","__idx":1},"children":["πŸ”§ How to enable EVENTS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable event data, simply include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"EVENT\""]}," in your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["options"]}," array along with any desired sub-options:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"options\": [ \"EVENT\", \"EVT_ELEVATION2\", \"EVT_TRAFFIC\" ]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This will activate the event system and return additional data for each segment of the route."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-available-event-sub-options","__idx":2},"children":["πŸ“‹ Available EVENT sub-options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list and reference of all ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVENT"]}," sub-options, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api-reference/routing/routing#event_sub-options"},"children":["API reference documentation"]},". This tutorial focuses on practical examples."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_duplicate_filter"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_duplicate_filter--filter-repeated-values","__idx":3},"children":["♻️ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_DUPLICATE_FILTER"]}," – Filter repeated values"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Avoid returning identical event data on every road segment when no change occurs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["πŸ“¦ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"destinations\": [ \n { \"coordinateSat\": { \"lon\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_DURATION\", \"EVT_DUPLICATE_FILTER\" ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This option filters out redundant values across consecutive road segments."," ","For example, if the speed limit or toll is the same for multiple segments, the value will only be returned once, reducing payload size and improving clarity"," ","πŸ“¨ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"usedDestinations\": [\n {\n \"inputOrder\": 0,\n \"used\": true,\n \"usedOrder\": 0,\n \"matchedCoordinateGps\": {\n \"lon\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":8479.75}\"\n }\n ]\n },\n {\n \"distance\": 222686,\n \"time\": 8480,\n \"percent\": 72.20172361245307,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"BEL\\\"}\"\n },\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":3937.12890625}\"\n }\n ]\n },\n {\n \"distance\": 308404,\n \"time\": 12417,\n \"percent\": 99.99416384045236,\n \"entries\": [\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":4.7890625}\"\n }\n ]\n }\n ]\n }\n ]\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_duration"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_duration--segment-duration","__idx":4},"children":["⏱️ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_DURATION"]}," – Segment duration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["βœ… Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add estimated travel time per segment (in seconds)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ“¦ Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"destinations\": [ \n { \"coordinateSat\": { \"lon\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"POLYLINE\", \"EVENT\", \"EVT_DURATION\" ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Appends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration"]}," field to each segment of the route. Useful for detailed timing analysis."," ","πŸ“¨ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"usedDestinations\": [\n {\n \"inputOrder\": 0,\n \"used\": true,\n \"usedOrder\": 0,\n \"matchedCoordinateGps\": {\n \"lon\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"polyline\": [\n {\n \"lon\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n {\n \"lon\": 2.3217,\n \"lat\": 48.86551\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":3.9375}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":10.10546875}\"\n }\n ]\n },\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_elevation2"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_elevation2--elevation-data","__idx":5},"children":["πŸ”οΈ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ELEVATION2"]}," – Elevation data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["βœ… Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include start and end altitude of each segment to assess elevation changes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ“¦ Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"destinations\": [ \n { \"coordinateSat\": { \"lon\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"POLYLINE\", \"EVENT\", \"EVT_ELEVATION2\" ]\n}\n","lang":"json"},"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":"code","attributes":{},"children":["startElevation"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["endElevation"]}," for each segment, enabling slope and terrain analysis."," ","πŸ“¨ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"usedDestinations\": [\n {\n \"inputOrder\": 0,\n \"used\": true,\n \"usedOrder\": 0,\n \"matchedCoordinateGps\": {\n \"lon\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"polyline\": [\n {\n \"lon\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n {\n \"lon\": 2.3217,\n \"lat\": 48.86551\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"Elevation2\",\n \"name\": \"altitude\",\n \"jsonObject\": \"{\\\"type\\\":\\\"Elevation2\\\",\\\"distance\\\":22,\\\"fromAltitude\\\":35.0,\\\"toAltitude\\\":34.0,\\\"length\\\":22.0,\\\"duration\\\":3.94}\"\n },\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"Elevation2\",\n \"name\": \"altitude\",\n \"jsonObject\": \"{\\\"type\\\":\\\"Elevation2\\\",\\\"distance\\\":78,\\\"fromAltitude\\\":34.0,\\\"toAltitude\\\":36.0,\\\"length\\\":56.0,\\\"duration\\\":10.11}\"\n },\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_encoded_polyline"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_encoded_polyline--encoded-segment-geometry","__idx":6},"children":["🧩 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ENCODED_POLYLINE"]}," – Encoded segment geometry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get a compact polyline geometry for each road segment using encoded format (smaller payload)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["πŸ“¦ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"destinations\": [ \n { \"coordinateSat\": { \"lon\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_ENCODED_POLYLINE\" ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds an encoded polyline (geometry) to each event segment, using a compressed format."," ","This is useful for minimizing response size when rendering geometry on a map client."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"String\",\n \"name\": \"encodedPolyline\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"i_giHyldMc@Y\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"String\",\n \"name\": \"encodedPolyline\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"m`giHsmdMcAg@YE\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_energy_consumption"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_energy_consumption--energy-estimation","__idx":7},"children":["πŸ”‹ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ENERGY_CONSUMPTION"]}," – Energy estimation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["βœ… Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Estimate energy consumption per segment (requires EV profile)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ“¦ Example"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"destinations\": [ \n { \"coordinateSat\": { \"lon\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\",\n \"routingEnergyVehicleFeature\": {\n \"initBatLevel\": 60,\n \"batCapacity\": 70,\n \"scx\": 0.6,\n \"crr\": 0.07,\n \"dryWeight\": 2000,\n \"engineEfficiency\": 0.6,\n \"maxAccel\": 130,\n \"maxDecel\": -100\n }\n },\n \"options\": [ \"EVENT\", \"EVT_ENERGY_CONSUMPTION\" ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provides energy cost and end-of-autonomy indicators. Useful for EV range prediction."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"energyConsumption\": 386.61808375813365,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_energy_consumption_sample"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_energy_consumption_sample--detailed-energy-sample-data","__idx":8},"children":["πŸ”‹ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ENERGY_CONSUMPTION_SAMPLE"]}," – Detailed energy sample data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve per-second energy consumption data along the route, useful for electric vehicle simulations."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\",\n \"routingEnergyVehicleFeature\": {\n \"initBatLevel\": 60,\n \"batCapacity\": 70,\n \"scx\": 0.6,\n \"crr\": 0.07,\n \"dryWeight\": 2000,\n \"engineEfficiency\": 0.6,\n \"maxAccel\": 130,\n \"maxDecel\": -100\n }\n },\n \"options\": [ \"EVENT\", \"EVT_ENERGY_CONSUMPTION_SAMPLE\" ]\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 an array of energy samples for each segment, with one entry per second."," ","Each sample includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["distFromStart (meters)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["speed (m/s)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["acceleration (m/sΒ²)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["angle (degrees)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["slope (coefficient)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cumulativeConsumption (Wh)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pos (WGS84 coordinates)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["altitude (meters)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ Requires routingEnergyVehicleFeature to be set in the vehicle profile."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"energyConsumption\": 386.61808375813365,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"EnergySample\",\n \"name\": \"energySample\",\n \"jsonObject\": \"{\\\"type\\\":\\\"EnergySample\\\",\\\"distFromStart\\\":0.0,\\\"speed\\\":5.6277354258978125,\\\"acceleration\\\":0.0,\\\"angle\\\":25.412364342910674,\\\"slope\\\":-0.03571428571428571,\\\"cumulativeConsumption\\\":0.0,\\\"pos\\\":{\\\"altitude\\\":34.79140029426688,\\\"longitude\\\":2.321574222824279,\\\"latitude\\\":48.86533125}}\"\n },\n {\n \"type\": \"EnergySample\",\n \"name\": \"energySample\",\n \"jsonObject\": \"{\\\"type\\\":\\\"EnergySample\\\",\\\"distFromStart\\\":5.6277354258978125,\\\"speed\\\":5.6277354258978125,\\\"acceleration\\\":0.0,\\\"angle\\\":25.412364342910674,\\\"slope\\\":-0.03571428571428571,\\\"cumulativeConsumption\\\":1.682558786543018,\\\"pos\\\":{\\\"altitude\\\":34.59040974334196,\\\"longitude\\\":2.321603015873016,\\\"latitude\\\":48.86537571428572}}\"\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_entry_value_as_object"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_entry_value_as_object--return-entries-as-json-objects","__idx":9},"children":["🧱 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ENTRY_VALUE_AS_OBJECT"]}," – Return entries as JSON objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure all event values are returned as structured JSON objects instead of plain strings."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_DURATION\", \"EVT_ENTRY_VALUE_AS_OBJECT\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, some event fields may be returned as strings."," ","This option forces all entries to use structured JSON format, making them easier to parse and consume programmatically."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"value\": \"FRA\"\n },\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"value\": 3.9375\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"value\": \"FRA\"\n },\n {\n \"type\": \"double\",\n \"name\": \"duration\",\n \"value\": 10.10546875\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_geoelement_type"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_geoelement_type--road-segment-type-and-classification","__idx":10},"children":["πŸ›£οΈ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_GEOELEMENT_TYPE"]}," – Road segment type and classification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Identify the type and administrative level of each road segment in the route."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_GEOELEMENT_TYPE\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["πŸ’‘ What it does"," ","Adds two classification fields to each segment event:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roadAdminLevel"]}]},": the administrative importance of the road",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Possible values"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FOURTH_ROAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TERTIARY_ROAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SECONDARY_ROAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAIN_ROAD"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["geoElementType"]}]},": the physical or functional type of the segment",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Possible values"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PEDESTRIAN"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROUNDABOUT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SLIP_ROAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROAD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MOTORWAY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FERRY"]}," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"GeoElementType\",\n \"name\": \"geoElementType\",\n \"jsonObject\": \"{\\\"type\\\":\\\"GeoElementType\\\",\\\"roadAdminLevel\\\":\\\"TERTIARY_ROAD\\\",\\\"geoElementType\\\":\\\"ROAD\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"GeoElementType\",\n \"name\": \"geoElementType\",\n \"jsonObject\": \"{\\\"type\\\":\\\"GeoElementType\\\",\\\"roadAdminLevel\\\":\\\"TERTIARY_ROAD\\\",\\\"geoElementType\\\":\\\"ROAD\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_length"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_length--segment-length-in-meters","__idx":11},"children":["πŸ“ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_LENGTH"]}," – Segment length in meters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Get the precise length of each road segment in the route."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_LENGTH\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}," ","Adds a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["length"]}," field (in meters) to each event segment."," ","This is useful for analytics, cost estimation, or visualizations based on segment size."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"long\",\n \"name\": \"length\",\n \"jsonObject\": \"{\\\"type\\\":\\\"long\\\",\\\"value\\\":22}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"long\",\n \"name\": \"length\",\n \"jsonObject\": \"{\\\"type\\\":\\\"long\\\",\\\"value\\\":56}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_objectid_base64"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_objectid_base64--encoded-segment-id","__idx":12},"children":["🧬 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_OBJECTID_BASE64"]}," – Encoded segment ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Retrieve a unique identifier for each segment, useful for map data versioning or tracking."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_OBJECTID_BASE64\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}," ","Adds an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["objectIdBase64"]}," field to each segment event."," ","This ID is a base64-encoded string uniquely identifying the road segment in BeNomad's map database."," ","It is linked to a specific map data release and can be used for version comparison or caching logic."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"String\",\n \"name\": \"objectIdBase64\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"CQAAAAvczwBGUkFfTkVPU05PRV9OVzI=\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"String\",\n \"name\": \"objectIdBase64\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"CQAAAGndzwBGUkFfTkVPU05PRV9OVzI=\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_polyline"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_polyline--raw-polyline-geometry","__idx":13},"children":["πŸ–ŠοΈ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_POLYLINE"]}," – Raw polyline geometry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get the full, unencoded geometry of each road segment for precise map rendering."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_POLYLINE\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["polyline"]}," field to each event segment, containing the full list of coordinates in WGS84 format."," ","Unlike ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ENCODED_POLYLINE"]},", this version is not encoded, which makes it easier to read or debug but results in larger payloads."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"Geometry\",\n \"name\": \"polyline\",\n \"jsonObject\": \"{\\\"type\\\":\\\"Geometry\\\",\\\"coordinates\\\":[{\\\"longitude\\\":2.321574222824279,\\\"latitude\\\":48.86533125},{\\\"longitude\\\":2.3217,\\\"latitude\\\":48.86551}]}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"Geometry\",\n \"name\": \"polyline\",\n \"jsonObject\": \"{\\\"type\\\":\\\"Geometry\\\",\\\"coordinates\\\":[{\\\"longitude\\\":2.3217,\\\"latitude\\\":48.86551},{\\\"longitude\\\":2.3219,\\\"latitude\\\":48.86585},{\\\"longitude\\\":2.32193,\\\"latitude\\\":48.86598}]}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_prohibited_driving"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_prohibited_driving--prohibited-driving-data","__idx":14},"children":["β›” ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_PROHIBITED_DRIVING"]}," – Prohibited driving data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Detect segments with driving restrictions such as wrong-way, blocked passages, or forbidden turns."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_PROHIBITED_DRIVING\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds restricted driving metadata to each event segment, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["againstTrafficDir"]},": indicates segments going against allowed traffic flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prohibitedTurn"]},": flags turns that are not allowed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prohibitedBlockedPassage"]},": indicates physically or legally blocked paths"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Useful for ensuring compliance with driving rules or enhancing safety checks."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"againstTrafficDir\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"prohibitedTurn\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"prohibitedBlockedPassage\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"againstTrafficDir\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"prohibitedTurn\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"prohibitedBlockedPassage\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_road_feature"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_road_feature--road-details","__idx":15},"children":["πŸ›£οΈ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ROAD_FEATURE"]}," – Road details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["βœ… Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve data about each segment’s characteristics (speed limit, lanes, etc.)."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_ROAD_FEATURE\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds structural road metadata to help evaluate route quality and constraints."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"maxSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":30}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"maxSpeedVerified\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"averageSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":20}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"transTypSpdLimit\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":30}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"freeFlowSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":20}\"\n },\n {\n \"type\": \"double\",\n \"name\": \"usedSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":20.0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"nbLaneNeg\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"nbLanePos\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":9}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"mainCategory\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":true}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"urbanArea\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":true}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"tunnel\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"bridge\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"carPool\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"dualCarriageway\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"noThroughTraffic\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"taxCategory\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"tollSide\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"offRoad\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"maxSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":30}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"maxSpeedVerified\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"averageSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":20}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"transTypSpdLimit\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":30}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"freeFlowSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":20}\"\n },\n {\n \"type\": \"double\",\n \"name\": \"usedSpeed\",\n \"jsonObject\": \"{\\\"type\\\":\\\"double\\\",\\\"value\\\":20.0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"nbLaneNeg\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"nbLanePos\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":9}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"mainCategory\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":true}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"urbanArea\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":true}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"tunnel\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"bridge\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"carPool\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"dualCarriageway\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"noThroughTraffic\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"taxCategory\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"int\",\n \"name\": \"tollSide\",\n \"jsonObject\": \"{\\\"type\\\":\\\"int\\\",\\\"value\\\":0}\"\n },\n {\n \"type\": \"boolean\",\n \"name\": \"offRoad\",\n \"jsonObject\": \"{\\\"type\\\":\\\"boolean\\\",\\\"value\\\":false}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_routesheet"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_routesheet--turn-by-turn-instructions","__idx":16},"children":["πŸ—ΊοΈ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_ROUTESHEET"]}," – Turn-by-turn instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["βœ… Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include detailed navigation instructions (turn left, continue, etc.)."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"POLYLINE\", \"EVENT\", \"EVT_ROUTESHEET\" ]\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 route sheet embedded within each event segment. Each step includes instructions and metadata."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"Routesheet\",\n \"name\": \"routesheet\",\n \"jsonObject\": \"{\\\"type\\\":\\\"Routesheet\\\",\\\"routingInstruction\\\":{\\\"type\\\":\\\"FOLLOW\\\",\\\"geoElementType\\\":\\\"ROAD\\\",\\\"length\\\":158,\\\"duration\\\":36,\\\"fromName\\\":\\\"Place de la Concorde\\\",\\\"manoeuvre\\\":\\\"STRAIGHT\\\",\\\"coordinateWgs84\\\":{\\\"longitude\\\":2.322,\\\"latitude\\\":48.86669},\\\"roundAboutExitNumber\\\":0,\\\"toName\\\":\\\"Rue Royale\\\",\\\"toOn\\\":\\\"Rue Royale\\\",\\\"textDist\\\":\\\"At 158 meters\\\",\\\"text\\\":\\\"From Place de la Concorde straight on Rue Royale\\\"}}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_segment_info"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_segment_info--segment-id-and-direction","__idx":17},"children":["🧩 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_SEGMENT_INFO"]}," – Segment ID and direction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get technical information about each segment, including its unique ID and travel direction."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_SEGMENT_INFO\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds metadata to each event segment:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segmentId"]},": unique identifier for the segment (if available in map data)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reverseDirection"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," if the segment is traversed in the opposite direction to how it’s stored in the map"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is helpful for advanced navigation engines, debugging route behavior, or reconstructing path logic from the event stream."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"SegmentInfo\",\n \"name\": \"segmentInfo\",\n \"jsonObject\": \"{\\\"type\\\":\\\"SegmentInfo\\\",\\\"id\\\":\\\"959514105\\\",\\\"length\\\":22,\\\"duration\\\":4,\\\"reverseDirection\\\":false}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"SegmentInfo\",\n \"name\": \"segmentInfo\",\n \"jsonObject\": \"{\\\"type\\\":\\\"SegmentInfo\\\",\\\"id\\\":\\\"1214393378\\\",\\\"length\\\":56,\\\"duration\\\":10,\\\"reverseDirection\\\":false}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_tax_cost"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_tax_cost--tax-cost-calculation","__idx":18},"children":["πŸ’° ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_TAX_COST"]}," – Tax cost calculation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Estimate the tax-related cost per road segment, useful for logistics or transport budgeting."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\",\n \"routingVehicleFeature\": {\n \"vehicleType\": \"CAR\",\n \"axleNumber\": 4\n }\n },\n \"options\": [ \"EVENT\", \"EVT_TAX_COST\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TaxCost"]}," entry to each event segment, containing fields like:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RoutingTaxCst"]},": total tax value"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RoutingTaxSect"]},": tax per segment (if applicable)"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["⚠️ Requires:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A complete ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]}," including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleFeature"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Specific map data (contact support to enable)"," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_toll_cost"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-evt_toll_cost--toll-cost-calculation","__idx":19},"children":["πŸ›£οΈ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_TOLL_COST"]}," – Toll cost calculation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Estimate toll costs per road segment, especially for trucks or paid highways."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\",\n \"routingVehicleFeature\": {\n \"vehicleType\": \"TRUCK\",\n \"emissionClass\": \"EURO6\"\n }\n },\n \"options\": [ \"EVENT\", \"EVT_TOLL_COST\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TollCost"]}," entry to each event segment, with fields like:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RoutingTollCst"]},": total toll amount"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tol"]},": toll details per section"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["⚠️ Requires:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleProfile"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["routingVehicleFeature"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specific toll map data (contact support to activate)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Useful for trip cost estimation, invoicing, or route optimization avoiding excessive tolls."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12433,\n \"length\": 308600\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308600,\n \"duration\": 12433,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.35574,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"routingTollCost\": {\n \"sumFees\": [\n {\n \"currency\": \"EUR\",\n \"feeMin\": 9.6,\n \"feeMax\": 16\n }\n ]\n },\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.00712896953985742,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_traffic"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_traffic--real-time-traffic-information","__idx":20},"children":["🚦 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_TRAFFIC"]}," – Real-time traffic information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get real-time traffic conditions per segment for display, alerting, or post-analysis."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_TRAFFIC\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}," ","Adds a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TrafficElement"]}," to each event segment, including:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jamFactor"]}," (in %): traffic congestion level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reason"]},": textual reason for the traffic (e.g., \"accident\", \"congestion\")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currentAvrSpeed"]},": average speed currently observed (in km/h)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["freeFlowAvrSpeed"]},": normal average speed without congestion (in km/h)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["⚠️ Note:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This option does not alter the computed route."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To influence the routing based on traffic, you must add the global ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"TRAFFIC\""]}," option."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requires specific real-time traffic map data (contact support to enable)."," ","πŸ“¨ ",{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"TrafficElement\",\n \"name\": \"trafficElement\",\n \"jsonObject\": \"{\\\"type\\\":\\\"TrafficElement\\\",\\\"trafficElement\\\":{\\\"info\\\":{\\\"countryCode\\\":\\\"FRA\\\",\\\"copyright\\\":\\\"HERE\\\",\\\"releaseDate\\\":1751617887000,\\\"lastUpdateDate\\\":1751617948055},\\\"elementId\\\":\\\"520538604\\\",\\\"reverseDirection\\\":true,\\\"boundingBoxWgs84\\\":{\\\"minXLongitude\\\":2.32084,\\\"minYLatitude\\\":48.86465,\\\"maxXLongitude\\\":2.32193,\\\"maxYLatitude\\\":48.86653},\\\"jamFactor\\\":54.3656,\\\"reason\\\":\\\"NA\\\",\\\"reasonCoordinate\\\":{\\\"longitude\\\":2.32193,\\\"latitude\\\":48.86615},\\\"polyline\\\":[{\\\"longitude\\\":2.32193,\\\"latitude\\\":48.86615},{\\\"longitude\\\":2.32187,\\\"latitude\\\":48.86653},{\\\"longitude\\\":2.32084,\\\"latitude\\\":48.86465},{\\\"longitude\\\":2.32093,\\\"latitude\\\":48.86467},{\\\"longitude\\\":2.32103,\\\"latitude\\\":48.8647},{\\\"longitude\\\":2.32154,\\\"latitude\\\":48.86528},{\\\"longitude\\\":2.3217,\\\"latitude\\\":48.86551},{\\\"longitude\\\":2.3219,\\\"latitude\\\":48.86585},{\\\"longitude\\\":2.32193,\\\"latitude\\\":48.86598},{\\\"longitude\\\":2.32193,\\\"latitude\\\":48.86615}],\\\"segmentInfos\\\":[{\\\"id\\\":\\\"68573794\\\",\\\"reverseDirection\\\":true},{\\\"id\\\":\\\"708801412\\\",\\\"reverseDirection\\\":false},{\\\"id\\\":\\\"56243920\\\",\\\"reverseDirection\\\":false},{\\\"id\\\":\\\"959514105\\\",\\\"reverseDirection\\\":false},{\\\"id\\\":\\\"708801413\\\",\\\"reverseDirection\\\":false},{\\\"id\\\":\\\"1214393378\\\",\\\"reverseDirection\\\":false},{\\\"id\\\":\\\"1214393379\\\",\\\"reverseDirection\\\":false}],\\\"tmcInternalId\\\":520538604,\\\"alertcEbuCountryCode\\\":\\\"F\\\",\\\"alertcTableId\\\":32,\\\"alertcLocationId\\\":51692,\\\"alertcExtend\\\":0,\\\"alertcCode\\\":115},\\\"currentJamFactor\\\":54.3656,\\\"statisticJamFactor\\\":0.0}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_traffic_signs"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_traffic_signs--traffic-signs","__idx":21},"children":["🚧 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_TRAFFIC_SIGNS"]}," – Traffic signs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["βœ… Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Display visual and contextual traffic signs along the route segments to enhance safety alerts and navigation awareness."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"POLYLINE\", \"EVENT\", \"EVT_TRAFFIC_SIGNS\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds traffic sign data to the event structure for each segment, with the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["text"]}," (optional): descriptive text below the sign."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matchedCoordinate"]},": WGS84 location of the traffic sign."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["category"]},": classification of the sign."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ“‘ Available ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["category"]}," values include:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_SUPPORTED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROAD_NARROWS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SHARP_CURVE_LEFT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SHARP_CURVE_RIGHT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WINDING_RD_LEFT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WINDING_RD_RIGHT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STEEP_HILL_UP"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STEEP_HILL_DOWN"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LATERAL_WIND"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERAL_WARNING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RISK_OF_GROUNDING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERAL_CURVE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERAL_HILL"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OBJECT_OVERHANG"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ST_NO_OVERTAKING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["END_NO_OVERTAKING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PR_OVERTAKING_EL"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PR_OVERTAKING_ELR"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PR_OVERTAKING_ELL"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LANE_MERGE_RIGHT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LANE_MERGE_LEFT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LANE_MERGE_CENTER"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RAILWAY_CROSS_PR"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RAILWAY_CROSS_UNPR"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ST_NO_OVERTAKING_TRUCKS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["END_NO_OVERTAKING_TRUCKS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STOP"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["END_OF_ALL_RESTRICTIONS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ANIMAL_CROSSING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ICY_CONDITIONS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SLIPPERY_ROAD"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FALLING_ROCKS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCHOOL_ZONE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRAMWAY_CROSSING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CONGESTION_HAZARD"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCIDENT_HAZARD"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRIORITY_ONCOMING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YIELD_ONCOMING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RIGHT_PRIORITY"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PEDESTRIAN_CROSSING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YIELD"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_ENGINE_BRAKE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ENDOF_NO_ENGINE_BRAKE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_IDLING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRUCK_ROLLOVER"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LOW_GEAR"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ENDOF_LOW_GEAR"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LIGHT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOUBLE_HAIRPIN"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRIPLE_HAIRPIN"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TWO_WAY_TRAFFIC"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["URBAN_AREA"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HUMP_BRIDGE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNEVEN_ROAD"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BICYCLE_CROSSING"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YIELD_TO_BICYCLES"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_TOWED_CARAVAN"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_TOWED_TRAILER"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_CAMPER"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_TURN_ON_RED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TURN_ON_RED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EMBANKMENT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FLOOD_AREA"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OBSTACLE"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROAD_SPLIT"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["⚠️ Requires map data including traffic sign annotations. Contact support to enable this feature."]}]}]},{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"name":"evt_waypoints"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-evt_waypoints--waypoints-along-the-route","__idx":22},"children":["πŸ“ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVT_WAYPOINTS"]}," – Waypoints along the route"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["βœ… ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use case"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get reproducible waypoints along the computed route for syncing across devices or re-processing later."]},{"$$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\": 2.32158, \"lat\": 48.86533 } },\n { \"coordinateSat\": { \"lon\": 4.35655, \"lat\": 50.8447 } }\n ],\n \"routingVehicleProfile\": {\n \"transportMode\": \"CAR\"\n },\n \"options\": [ \"EVENT\", \"EVT_WAYPOINTS\" ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["πŸ’‘ What it does"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds a list of waypoints in the event structure. Each waypoint includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A coordinate (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lat"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lon"]},") in WGS84"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional metadata (e.g., order, original destination match, segment ID)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These waypoints represent key points along the route that can be:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Used to redraw the route on another map system"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reused as input for another routing query"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Synced across devices for continuity"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ideal for applications that need offline navigation continuity or route sharing."]},{"$$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\": 2.321574222824279,\n \"lat\": 48.86533125\n },\n \"confidenceValue\": 0.21240678521674997,\n \"distanceFromRequest\": 0.45,\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.356551936132446,\n \"lat\": 50.84469875\n },\n \"confidenceValue\": 0.07687516682978913,\n \"distanceFromRequest\": 0.14,\n \"polylineIndex\": -1,\n \"duration\": 12422,\n \"length\": 308422\n }\n ],\n \"routingRoutes\": [\n {\n \"length\": 308422,\n \"duration\": 12422,\n \"trafficDelay\": 0,\n \"averageSpeed\": 89.383286,\n \"maximumSpeed\": 0,\n \"startUTurnThreshold\": 3000,\n \"boundingBox\": {\n \"minLon\": 2.30156,\n \"minLat\": 48.86533125,\n \"maxLon\": 4.356551936132446,\n \"maxLat\": 50.84507\n },\n \"startStopInfo\": {\n \"start\": {\n \"lon\": 2.32157,\n \"lat\": 48.86533\n },\n \"stop\": {\n \"lon\": 4.35655,\n \"lat\": 50.8447\n },\n \"distanceFirstMatched\": 0.14,\n \"distanceLastMatched\": 0.14,\n \"interDests\": null\n },\n \"events\": [\n {\n \"type\": \"SEGMENT\",\n \"distanceUnit\": \"meters\",\n \"timeUnit\": \"seconds\",\n \"markers\": [\n {\n \"distance\": 0,\n \"time\": 0,\n \"percent\": 0,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n },\n {\n \"type\": \"Waypoint\",\n \"name\": \"waypoint\",\n \"jsonObject\": \"{\\\"type\\\":\\\"Waypoint\\\",\\\"waypoint\\\":{\\\"usedDestinationIndex\\\":0,\\\"polylineIndex\\\":-1,\\\"coordinate\\\":{\\\"lon\\\":2.321574222824279,\\\"lat\\\":48.86533125},\\\"angle\\\":25.0,\\\"radius\\\":0,\\\"uturn\\\":false,\\\"ignorePoint\\\":false,\\\"ignoreTrafficDirections\\\":false,\\\"ignoreRoadBlocks\\\":false,\\\"ignoreRestrictions\\\":false,\\\"avoidUTurn\\\":\\\"UNDEF\\\",\\\"useStartAngle\\\":\\\"UNDEF\\\",\\\"useStopRoadSide\\\":\\\"UNDEF\\\"}}\"\n }\n ]\n },\n {\n \"distance\": 22,\n \"time\": 4,\n \"percent\": 0.007133083891551187,\n \"entries\": [\n {\n \"type\": \"String\",\n \"name\": \"countryCode\",\n \"jsonObject\": \"{\\\"type\\\":\\\"String\\\",\\\"value\\\":\\\"FRA\\\"}\"\n }\n ]\n },\n"},"children":[]}]},"headings":[{"value":"πŸ›°οΈ Routing Event Tutorial","id":"️-routing-event-tutorial","depth":1},{"value":"πŸ”§ How to enable EVENTS","id":"-how-to-enable-events","depth":2},{"value":"πŸ“‹ Available EVENT sub-options","id":"-available-event-sub-options","depth":2},{"value":"♻️ EVT_DUPLICATE_FILTER – Filter repeated values","id":"️-evt_duplicate_filter--filter-repeated-values","depth":2},{"value":"⏱️ EVT_DURATION – Segment duration","id":"️-evt_duration--segment-duration","depth":2},{"value":"πŸ”οΈ EVT_ELEVATION2 – Elevation data","id":"️-evt_elevation2--elevation-data","depth":2},{"value":"🧩 EVT_ENCODED_POLYLINE – Encoded segment geometry","id":"-evt_encoded_polyline--encoded-segment-geometry","depth":2},{"value":"πŸ”‹ EVT_ENERGY_CONSUMPTION – Energy estimation","id":"-evt_energy_consumption--energy-estimation","depth":2},{"value":"πŸ”‹ EVT_ENERGY_CONSUMPTION_SAMPLE – Detailed energy sample data","id":"-evt_energy_consumption_sample--detailed-energy-sample-data","depth":2},{"value":"🧱 EVT_ENTRY_VALUE_AS_OBJECT – Return entries as JSON objects","id":"-evt_entry_value_as_object--return-entries-as-json-objects","depth":2},{"value":"πŸ›£οΈ EVT_GEOELEMENT_TYPE – Road segment type and classification","id":"️-evt_geoelement_type--road-segment-type-and-classification","depth":2},{"value":"πŸ“ EVT_LENGTH – Segment length in meters","id":"-evt_length--segment-length-in-meters","depth":2},{"value":"🧬 EVT_OBJECTID_BASE64 – Encoded segment ID","id":"-evt_objectid_base64--encoded-segment-id","depth":2},{"value":"πŸ–ŠοΈ EVT_POLYLINE – Raw polyline geometry","id":"️-evt_polyline--raw-polyline-geometry","depth":2},{"value":"β›” EVT_PROHIBITED_DRIVING – Prohibited driving data","id":"-evt_prohibited_driving--prohibited-driving-data","depth":2},{"value":"πŸ›£οΈ EVT_ROAD_FEATURE – Road details","id":"️-evt_road_feature--road-details","depth":2},{"value":"πŸ—ΊοΈ EVT_ROUTESHEET – Turn-by-turn instructions","id":"️-evt_routesheet--turn-by-turn-instructions","depth":2},{"value":"🧩 EVT_SEGMENT_INFO – Segment ID and direction","id":"-evt_segment_info--segment-id-and-direction","depth":2},{"value":"πŸ’° EVT_TAX_COST – Tax cost calculation","id":"-evt_tax_cost--tax-cost-calculation","depth":2},{"value":"πŸ›£οΈ EVT_TOLL_COST – Toll cost calculation","id":"️-evt_toll_cost--toll-cost-calculation","depth":2},{"value":"🚦 EVT_TRAFFIC – Real-time traffic information","id":"-evt_traffic--real-time-traffic-information","depth":2},{"value":"🚧 EVT_TRAFFIC_SIGNS – Traffic signs","id":"-evt_traffic_signs--traffic-signs","depth":2},{"value":"πŸ“ EVT_WAYPOINTS – Waypoints along the route","id":"-evt_waypoints--waypoints-along-the-route","depth":2}],"frontmatter":{"seo":{"title":"πŸ›°οΈ Routing Event Tutorial"}},"lastModified":"2025-08-26T13:53:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/routing/tutorial/routing_event","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}