TomTom Routing

Removed value: -{
-  "description": "Efficiency during acceleration (0-1).",
-  "type": "number"
-}

Removed value: -{
-  "description": "When maxAlternatives is greater than 0, it allows the definition of computing alternative routes: finding routes that are significantly different from the reference route, or finding routes that are better than the reference route. Possible values are: `anyRoute` (returns alternative routes that are significantly different from the reference route.), `betterRoute` (only returns alternative routes that are better than the reference route, according to the given planning criteria (set by routeType). If there is a road block on the reference route, then any alternative that does not contain any blockages will be considered a better route. The summary in the route response will contain information (see the planningReason parameter) about the reason for the better alternative.) Note: The betterRoute value can only be used when reconstructing a reference route. Default value: `anyRoute` Other values: `betterRoute`",
-  "enum": [
-    "anyRoute",
-    "betterRoute"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Auxiliary power consumption for combustion vehicles in L/hr.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Auxiliary power consumption in kW for electric vehicles.",
-  "type": "number"
-}

Previous value: -"Route features to avoid. May increase travel time. Options: 'tollRoads','motorways','ferries','unpavedRoads','carpools','alreadyUsedRoads'. Accepts array of string(s)."New value: +"Route features to avoid. May increase travel time."

Added value: +[
+  "tollRoads",
+  "motorways",
+  "ferries",
+  "unpavedRoads",
+  "carpools",
+  "alreadyUsedRoads",
+  "borderCrossings",
+  "tunnels",
+  "carTrains",
+  "lowEmissionZones"
+]

Removed value: -{
-  "description": "Comma-separated charge margins in kWh for route planning.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Reorder waypoints for optimization. Use with multiple waypoints to find the most efficient route order.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Calculate travel times for all segments ('all') or none ('none').",
-  "enum": [
-    "all",
-    "none"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Combustion speed-to-consumption mappings: '50,6.3:130,11.5' (speed in km/h, consumption in L/100km).",
-  "type": "string"
-}

Removed value: -{
-  "description": "EV speed-to-consumption mappings format: '50,8.2:130,21.3' (speed in km/h, consumption in kWh/100km).",
-  "type": "string"
-}

Removed value: -{
-  "description": "Energy used per km of altitude gain.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Current EV battery charge in kWh. Required for EV routing.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Current fuel level in liters for combustion vehicles.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Efficiency during deceleration (0-1).",
-  "type": "number"
-}

Removed value: -{
-  "description": "Destination coordinates. Obtain from geocoding for best results.",
-  "properties": {
-    "lat": {
-      "description": "Latitude coordinate (-90 to +90). Use precise coordinates from geocoding for best results.",
-      "type": "number"
-    },
-    "lon": {
-      "description": "Longitude coordinate (-180 to +180). Use precise coordinates from geocoding for best results.",
-      "type": "number"
-    }
-  },
-  "required": [
-    "lat",
-    "lon"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Efficiency during downhill driving (0-1).",
-  "type": "number"
-}

Removed value: -{
-  "description": "Additional routing data formats to include in the response.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Fuel energy density in megajoules per liter.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Preference for avoiding hills. Use 'low' for flatter routes.",
-  "enum": [
-    "low",
-    "normal",
-    "high"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Include toll payment types in the toll section. If a toll section has different toll payment types in its subsections, this toll section is split into multiple toll sections with the toll payment types. Possible values: all(Include toll payment types in the toll section.), none (Do not include toll payment types in the toll section). The value `all` must be used together with sectionType=toll. Default value: none",
-  "type": "string"
-}

Removed value: -{
-  "description": "Instruction format: 'text' (human-readable), 'coded' (machine-readable), 'tagged' (HTML).",
-  "enum": [
-    "coded",
-    "text",
-    "tagged"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Language code for instructions (e.g., 'en-US', 'de-DE').",
-  "type": "string"
-}

Added value: +{
+  "description": "Ordered list of coordinates [origin, ...intermediateStops, destination]. Minimum 2 (origin + destination); add intermediate positions for multi-stop routes. Use geocoding for accurate coordinates.",
+  "items": {
+    "description": "Position as [longitude, latitude] (GeoJSON convention, lng first). Example: [4.89707, 52.377956] for Amsterdam, [13.404954, 52.520008] for Berlin.",
+    "items": {
+      "type": "number"
+    },
+    "maxItems": 2,
+    "minItems": 2,
+    "type": "array"
+  },
+  "minItems": 2,
+  "type": "array"
+}

Removed value: -{
-  "description": "Maximum EV battery capacity in kWh. Required for EV routing.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Starting point coordinates. Obtain from geocoding for best results.",
-  "properties": {
-    "lat": {
-      "description": "Latitude coordinate (-90 to +90). Use precise coordinates from geocoding for best results.",
-      "type": "number"
-    },
-    "lon": {
-      "description": "Longitude coordinate (-180 to +180). Use precise coordinates from geocoding for best results.",
-      "type": "number"
-    }
-  },
-  "required": [
-    "lat",
-    "lon"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Energy recovered per km of altitude loss.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Specifies which data should be reported for diagnostic purposes. A possible value is: `effectiveSettings`. Reports the effective parameters or data used when calling the API. In the case of defaulted parameters, the default will be reflected where the parameter was not specified by the caller. Default value: effectiveSettings",
-  "type": "string"
-}

Previous value: -"Response detail level. 'compact' (default): trimmed response with essential fields only, saves tokens. 'full': complete API response with all fields including coordinates, classifications, etc."New value: +"Response detail level. 'compact' (default): essential fields and point coordinates, no geometry. 'geometry': compact plus a 'geometry' key holding a GeoJSON FeatureCollection ([lon, lat], at most 1,000 vertices per feature); use this to get coordinates to draw or process. 'full': the raw API response, lossless and many times larger."

Previous value: -[
-  "compact",
-  "full"
-]New value: +[
+  "compact",
+  "geometry",
+  "full"
+]

Removed value: -{
-  "description": "Representation of routes in response: 'polyline' (default, includes points), 'encodedPolyline' (compressed format), 'summaryOnly' (no points), 'none' (with computeBestOrder only). It cannot be used when `maxAlternatives` is set",
-  "enum": [
-    "polyline",
-    "summaryOnly",
-    "encodedPolyline",
-    "none"
-  ],
-  "type": "string"
-}

Previous value: -"Route optimization: 'fastest' (time-optimized), 'shortest' (distance-optimized), 'eco' (fuel-efficient), 'thrilling' (scenic)."New value: +"Route optimization: 'fast' (time-optimized), 'short' (distance-optimized), 'efficient' (fuel-efficient), 'thrilling' (scenic). Default: 'fast'."

Previous value: -[
-  "fastest",
-  "shortest",
-  "eco",
-  "thrilling"
-]New value: +[
+  "fast",
+  "short",
+  "efficient",
+  "thrilling"
+]

Previous value: -"Highlight specific road section types in response for route analysis: toll (toll roads), motorway (highways), tunnel, urban (city areas), country (rural areas), pedestrian (walking paths), etc."New value: +"Keep only these section types in the route, besides leg. Default: all types the route has. Compact responses drop the map-rendering types (urban, tunnel, motorway, lowEmissionZone, pedestrian, speedLimit, roadShields, vehicleRestricted); they appear only with response_detail 'full'."

Added value: +[
+  "carpool",
+  "carTrain",
+  "country",
+  "ferry",
+  "importantRoadStretch",
+  "lowEmissionZone",
+  "motorway",
+  "pedestrian",
+  "roadShields",
+  "speedLimit",
+  "toll",
+  "tollRoad",
+  "tollVignette",
+  "traffic",
+  "tunnel",
+  "unpaved",
+  "urban",
+  "vehicleRestricted"
+]

Added value: +{
+  "default": false,
+  "description": "Request the interactive map widget. Only hosts that support MCP Apps render it. It adds no coordinates to the text response. Default: false",
+  "type": "boolean"
+}

Removed value: -{
-  "description": "Additional coordinates that influence the route shape without being stops (format: 'lat,lon;lat,lon').",
-  "type": "string"
-}

Previous value: -"Include real-time traffic data for more accurate ETAs and route suggestions."New value: +"Traffic consideration: 'live' (real-time + historical), 'historical' (historical only)."

Added value: +[
+  "live",
+  "historical"
+]

Previous value: -"boolean"New value: +"string"

Previous value: -[
-  "car",
-  "pedestrian",
-  "bicycle",
-  "truck",
-  "taxi",
-  "bus",
-  "van"
-]New value: +[
+  "car"
+]

Removed value: -{
-  "description": "Efficiency during uphill driving (0-1).",
-  "type": "number"
-}

Removed value: -{
-  "description": "ADR tunnel restriction code for hazardous materials.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Vehicle axle weight in kg for weight-restricted roads.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Commercial vehicle flag. Affects road access restrictions.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Engine type for fuel/energy consumption calculation.",
-  "enum": [
-    "combustion",
-    "electric"
-  ],
-  "type": "string"
-}

Previous value: -"Heading of the vehicle in degrees (0-359) for more accurate initial routing."New value: +"Heading of the vehicle at the origin, in degrees clockwise from north (0-359), for a route that starts in the direction of travel."

Added value: +359

Added value: +0

Removed value: -{
-  "description": "Vehicle height in meters. Used to avoid low bridges.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Vehicle length in meters. Affects maneuverability restrictions.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Cargo type for hazardous materials routing.",
-  "type": "string"
-}

Added value: +0

Removed value: -{
-  "description": "Number of axles on the vehicle. Used for toll calculations and restrictions.",
-  "type": "number"
-}

Previous value: -"Vehicle weight in kg. Important for truck routing restrictions."New value: +"Vehicle weight in kg."

Added value: +0

Removed value: -{
-  "description": "Vehicle width in meters. Used to avoid narrow roads.",
-  "type": "number"
-}

Removed value: -{
-  "description": "Preference for avoiding winding roads. Use 'low' for straighter routes.",
-  "enum": [
-    "low",
-    "normal",
-    "high"
-  ],
-  "type": "string"
-}

Previous value: -[
-  "origin",
-  "destination"
-]New value: +[
+  "locations"
+]

Removed value: -false

Removed value: -false

Removed value: -"#/properties/origin/properties/lat"

Added value: +"Latitude coordinate (-90 to +90). Use precise coordinates from geocoding for best results."

Added value: +"number"

Removed value: -"#/properties/origin/properties/lon"

Added value: +"Longitude coordinate (-180 to +180). Use precise coordinates from geocoding for best results."

Added value: +"number"

Removed value: -false

Added value: +{
+  "default": "compact",
+  "description": "Response detail level. 'compact' (default): trimmed response with essential fields only, saves tokens. 'full': complete API response with all fields including coordinates, classifications, etc.",
+  "enum": [
+    "compact",
+    "full"
+  ],
+  "type": "string"
+}