{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"🎯 TraceRoute - destinations List of GPS Coordinates","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-traceroute---destinations-list-of-gps-coordinates","__idx":0},"children":["🎯 TraceRoute - destinations List of GPS Coordinates"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-description","__idx":1},"children":["📌 Description"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destinations"]}," field is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]},". It defines the list of GPS coordinates to match to the road network. Each point will be processed in sequence to reconstruct the route trace."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TraceRouteDest[]"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-field-breakdown","__idx":2},"children":["🔍 Field Breakdown"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinateSat.lat"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latitude in decimal degrees (WGS84)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinateSat.lon"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Longitude in decimal degrees (WGS84)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinateSat.speed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Speed in km/h. Used to refine ETA if provided."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinateSat.time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp in milliseconds since Epoch (UTC)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keptByMinimalWp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", forces the waypoint to be kept even if simplification is applied."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of key-value pairs to tag the coordinate with custom info."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-example--minimal","__idx":3},"children":["📤 Example – Minimal"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162\n      }\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 180,\n      \"width\": 180,\n      \"length\": 475,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ This creates a basic trace between two points (e.g., Eiffel Tower → Louvre)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-example--with-speed","__idx":4},"children":["📤 Example – With Speed"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616,\n        \"speed\": 23.1\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162,\n        \"speed\": 29.3\n      }\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 180,\n      \"width\": 180,\n      \"length\": 475,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Used to refine ETA calculation based on vehicle speed at each point."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-example---with-heading","__idx":5},"children":["📤 Example - With Heading"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616,\n        \"heading\": 17.6\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162,\n        \"heading\": 95.0\n      }\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 180,\n      \"width\": 180,\n      \"length\": 475,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Heading is used to indicate the vehicle's direction (90° = East)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-example--with-time","__idx":6},"children":["📤 Example – With Time"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616,\n        \"time\": 1396241966000\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162,\n        \"time\": 1396241972000\n      }\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 180,\n      \"width\": 180,\n      \"length\": 475,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Use when you want ETA to align with the time of each point (requires adjustEta: true in main request)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-example---with-sat","__idx":7},"children":["📤 Example - With Sat"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616,\n        \"sat\": 11\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162,\n        \"sat\": 11\n      },\n      \"keptByMinimalWp\": true\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 180,\n      \"width\": 180,\n      \"length\": 475,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Satellite count can improve location accuracy and matching quality."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-example--with-keptbyminimalwp","__idx":8},"children":["📤 Example – With keptByMinimalWp"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162\n      },\n      \"keptByMinimalWp\": true\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 180,\n      \"width\": 180,\n      \"length\": 475,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Forces the waypoint to be retained even if the system applies simplification (e.g. NO_MINIMAL_WAYPOINTS is not used)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-example--with-customdata","__idx":9},"children":["📤 Example – With customData"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"destinations\": [\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.066,\n        \"lat\": 43.616\n      }\n    },\n    {\n      \"coordinateSat\": {\n        \"lon\": 7.0664,\n        \"lat\": 43.6162\n      },\n      \"customData\": [\n        {\n          \"key\": \"driver\",\n          \"value\": \"john_doe\"\n        },\n        {\n          \"key\": \"weather\",\n          \"value\": \"rain\"\n        }\n      ]\n    }\n  ],\n  \"routingVehicleProfile\": {\n    \"transportMode\": \"CAR\",\n    \"routingVehicleFeature\": {\n      \"height\": 160,\n      \"width\": 180,\n      \"length\": 450,\n      \"weight\": 2,\n      \"axleWeight\": 1\n    }\n  },\n  \"options\": [\"ROUTESHEET\", \"POLYLINE\", \"POLYLINE_INDEX\"]\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Adds extra tags to a waypoint, useful for post-processing or debugging."]}]}]},"headings":[{"value":"🎯 TraceRoute - destinations List of GPS Coordinates","id":"-traceroute---destinations-list-of-gps-coordinates","depth":2},{"value":"📌 Description","id":"-description","depth":3},{"value":"🔍 Field Breakdown","id":"-field-breakdown","depth":2},{"value":"📤 Example – Minimal","id":"-example--minimal","depth":2},{"value":"📤 Example – With Speed","id":"-example--with-speed","depth":3},{"value":"📤 Example - With Heading","id":"-example---with-heading","depth":3},{"value":"📤 Example – With Time","id":"-example--with-time","depth":3},{"value":"📤 Example - With Sat","id":"-example---with-sat","depth":3},{"value":"📤 Example – With keptByMinimalWp","id":"-example--with-keptbyminimalwp","depth":3},{"value":"📤 Example – With customData","id":"-example--with-customdata","depth":3}],"frontmatter":{"seo":{"title":"🎯 TraceRoute - destinations List of GPS Coordinates"}},"lastModified":"2025-09-29T08:13:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/traceroute/tutorial/traceroute_destination_tutorial","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}