Previous value: -"Willingness to ride roads alongside motor traffic, 0.0–1.0\n(0.0 = prefer cycleways and quiet streets — the quiet-ride slider)."New value: +"Willingness to ride roads alongside motor traffic, 0.0–1.0\n(0.0 = prefer cycleways and quiet streets, the quiet-ride slider)."

Previous value: -"Its Euro emission standard, 1–6. Heavy-duty approvals are written\nin Roman numerals (Euro VI); declare Euro VI as `6`. Required for\nany combustion fuel — without it no zone can be resolved, and a\nhalf-declared vehicle is indistinguishable from an undeclared one.\nOptional only for `electric` or `hydrogen`."New value: +"Its Euro emission standard, 1–6. Heavy-duty approvals are written\nin Roman numerals (Euro VI); declare Euro VI as `6`. Required for\nany combustion fuel, without it no zone can be resolved, and a\nhalf-declared vehicle is indistinguishable from an undeclared one.\nOptional only for `electric` or `hydrogen`."

Previous value: -"A road feature to exclude outright. A hard exclusion can leave a request with no path at all — that is the honest answer, not a failure — and it depends on the routing engine's own hard-exclusion setting, which nothing here can read."New value: +"A road feature to exclude outright. A hard exclusion can leave a request with no path at all (that is the honest answer, not a failure) and it depends on the routing engine's own hard-exclusion setting, which nothing here can read."

Previous value: -"Preference for lit streets, 0.0–1.0 (1.0 = prefer lit paths as\nstrongly as possible — the \"walk me home on lit streets\" option).\nUnlit ways are still used when no lit alternative exists."New value: +"Preference for lit streets, 0.0–1.0 (1.0 = prefer lit paths as\nstrongly as possible, the \"walk me home on lit streets\" option).\nUnlit ways are still used when no lit alternative exists."

Previous value: -[
-  {
-    "const": "same",
-    "description": "The side the location itself projects to — the kerb, resolved\nagainst the locale's driving side (the left kerb in the UK, the\nright in Germany).",
-    "type": "string"
-  },
-  {
-    "const": "opposite",
-    "description": "The far side of the road from the location.",
-    "type": "string"
-  },
-  {
-    "const": "either",
-    "description": "No side preference.",
-    "type": "string"
-  },
-  {
-    "const": "curb",
-    "description": "Alias for `same`, from the OSRM/Mapbox `approaches` vocabulary.",
-    "type": "string"
-  },
-  {
-    "const": "unrestricted",
-    "description": "Alias for `either`, from the OSRM/Mapbox `approaches` vocabulary.",
-    "type": "string"
-  }
-]New value: +[
+  {
+    "const": "same",
+    "description": "The side the location itself projects to, the kerb, resolved\nagainst the locale's driving side (the left kerb in the UK, the\nright in Germany).",
+    "type": "string"
+  },
+  {
+    "const": "opposite",
+    "description": "The far side of the road from the location.",
+    "type": "string"
+  },
+  {
+    "const": "either",
+    "description": "No side preference.",
+    "type": "string"
+  },
+  {
+    "const": "curb",
+    "description": "Alias for `same`, from the OSRM/Mapbox `approaches` vocabulary.",
+    "type": "string"
+  },
+  {
+    "const": "unrestricted",
+    "description": "Alias for `either`, from the OSRM/Mapbox `approaches` vocabulary.",
+    "type": "string"
+  }
+]

Previous value: -"One location of a `route` request: a coordinate, plus the optional\nkerbside approach for arriving at it.\n\nA bare `{lat, lon}` is still a complete location — every kerbside field\nis optional and omitting all of them is exactly the request that was\nmade before they existed."New value: +"One location of a `route` request: a coordinate, plus the optional\nkerbside approach for arriving at it.\n\nA bare `{lat, lon}` is still a complete location, every kerbside field\nis optional and omitting all of them is exactly the request that was\nmade before they existed."

Previous value: -"Which side of the street to arrive on (or depart from). `same` (or\n`curb`) puts the vehicle on the door's side of the road, resolved\nagainst the locale's driving side. Two honest limits: this is a\n**snapping preference**, not a manoeuvre guarantee — the engine\nprefers an edge on that side, it does not promise the driver never\ncrosses — and it needs a coordinate genuinely offset from the road\ncentreline, because a point on the centreline has no side."New value: +"Which side of the street to arrive on (or depart from). `same` (or\n`curb`) puts the vehicle on the door's side of the road, resolved\nagainst the locale's driving side. Two honest limits: this is a\n**snapping preference**, not a manoeuvre guarantee, the engine\nprefers an edge on that side, it does not promise the driver never\ncrosses, and it needs a coordinate genuinely offset from the road\ncentreline, because a point on the centreline has no side."

Previous value: -"ADR 8.6.4 tunnel restriction code of the load, e.g. \"B\", \"C5000D\",\n\"B/D\", or \"(—)\"/\"none\" for explicitly unrestricted. Leave unset if\nunknown: a hazmat load without a code is conservatively treated as\ncode B (allowed only through category-A tunnels)."New value: +"ADR 8.6.4 tunnel restriction code of the load, e.g. \"B\", \"C5000D\",\n\"B/D\", or \"(-)\"/\"none\" for explicitly unrestricted. Leave unset if\nunknown: a hazmat load without a code is conservatively treated as\ncode B (allowed only through category-A tunnels)."

Previous value: -"Road features to avoid as a PREFERENCE. Rendered as the costing's\nwillingness factor set to zero — a thumb on the scale, not a ban.\nThe engine's own reference is explicit that a value of zero is not\nguaranteed to avoid the feature entirely, and it does not: asking\nto avoid tolls across the Dartford Crossing returns the same tolled\nroute, because the untolled alternative is fifty kilometres\nfurther. Use `exclude` when you mean a ban."New value: +"Road features to avoid as a PREFERENCE. Rendered as the costing's\nwillingness factor set to zero, a thumb on the scale, not a ban.\nThe engine's own reference is explicit that a value of zero is not\nguaranteed to avoid the feature entirely, and it does not: asking\nto avoid tolls across the Dartford Crossing returns the same tolled\nroute, because the untolled alternative is fifty kilometres\nfurther. Use `exclude` when you mean a ban."

Previous value: -"Road features to exclude outright, rendered as the costing's hard\nexclusion flag. Two things follow from that and both matter: a hard\nexclusion can return NO ROUTE rather than a detour (excluding\ntunnels on a Rotherhithe crossing has no answer), and the flags\ndepend on the routing engine's `allow_hard_exclusions` setting,\nwhich the engine does not expose and nothing here can read — so\nthis is never promised, only requested."New value: +"Road features to exclude outright, rendered as the costing's hard\nexclusion flag. Two things follow from that and both matter: a hard\nexclusion can return NO ROUTE rather than a detour (excluding\ntunnels on a Rotherhithe crossing has no answer), and the flags\ndepend on the routing engine's `allow_hard_exclusions` setting,\nwhich the engine does not expose and nothing here can read, so\nthis is never promised, only requested."

Previous value: -"Areas to avoid — scenario analysis (\"close this bridge and\nre-route\"): an array of polygons, each an array of `[lon, lat]`\npairs forming one exterior ring (GeoJSON-style, longitude FIRST).\nRoads intersecting any ring are excluded from the search. Applies\nto the Valhalla engine; unsupported on the GraphHopper engine,\nwhere it is ignored."New value: +"Areas to avoid, scenario analysis (\"close this bridge and\nre-route\"): an array of polygons, each an array of `[lon, lat]`\npairs forming one exterior ring (GeoJSON-style, longitude FIRST).\nRoads intersecting any ring are excluded from the search. Applies\nto the Valhalla engine; unsupported on the GraphHopper engine,\nwhere it is ignored."

Previous value: -"Name landmarks in the turn instructions (default false): each\nmanoeuvre that passes a recognisable place — a petrol station, a\nsupermarket, a household-name chain — gains a\n`landmark_instruction` like \"Turn right just after the Shell\ngarage\" beside the engine's own street-name instruction, which is\nnever replaced. Nothing is named unless it is recognisable from the\nroad, within 40 m of the junction and not tagged as closed, so many\nroutes come back with none: a wrong landmark is worse than no\nlandmark. Needs the MapMap gateway, whose place index does the\nlookup."New value: +"Name landmarks in the turn instructions (default false): each\nmanoeuvre that passes a recognisable place, a petrol station, a\nsupermarket, a household-name chain, gains a\n`landmark_instruction` like \"Turn right just after the Shell\ngarage\" beside the engine's own street-name instruction, which is\nnever replaced. Nothing is named unless it is recognisable from the\nroad, within 40 m of the junction and not tagged as closed, so many\nroutes come back with none: a wrong landmark is worse than no\nlandmark. Needs the MapMap gateway, whose place index does the\nlookup."

Previous value: -"Explain the route (default false): re-routes with each declared\ntruck constraint (truck costing) or avoidance-side routing\npreference (auto, bicycle, pedestrian, motor_scooter) relaxed and\nreports the ones that actually changed the route as\n`rationale.avoided[]`. Opt-in — it costs up to 1 + N extra routing\ncalls, one per declared field plus one combined probe, and it is\nbilled for the ones it actually makes: at most 8 in total,\ntypically fewer, and 1 when there is nothing to probe. Against the\nhosted gateway each probe is its own metered route call, which is\nexactly what `POST /route` with `rationale: true` charges for its\nown fan-out, so the two surfaces price the same explanation the\nsame way."New value: +"Explain the route (default false): re-routes with each declared\ntruck constraint (truck costing) or avoidance-side routing\npreference (auto, bicycle, pedestrian, motor_scooter) relaxed and\nreports the ones that actually changed the route as\n`rationale.avoided[]`. Opt-in, it costs up to 1 + N extra routing\ncalls, one per declared field plus one combined probe, and it is\nbilled for the ones it actually makes: at most 8 in total,\ntypically fewer, and 1 when there is nothing to probe. Against the\nhosted gateway each probe is its own metered route call, which is\nexactly what `POST /route` with `rationale: true` charges for its\nown fan-out, so the two surfaces price the same explanation the\nsame way."

Previous value: -"The ADR costing that was merged into a truck route request.\n\nEvery field here describes the **request**: the declared load and the\ncosting options built from it. Nothing here is an assertion about the\nreturned geometry — see [`TunnelEnforcement`]."New value: +"The ADR costing that was merged into a truck route request.\n\nEvery field here describes the **request**: the declared load and the\ncosting options built from it. Nothing here is an assertion about the\nreturned geometry, see [`TunnelEnforcement`]."

Previous value: -"ADR tunnel categories **the vehicle** is forbidden from under the\nworst-case reading of ADR 8.6.4 (conditional clauses assumed to\napply). Empty when unrestricted. This is not a claim that the\nreturned route contains no tunnel of these categories — read\n[`AppliedAdr::tunnel_enforcement`] for what was actually applied."New value: +"ADR tunnel categories **the vehicle** is forbidden from under the\nworst-case reading of ADR 8.6.4 (conditional clauses assumed to\napply). Empty when unrestricted. This is not a claim that the\nreturned route contains no tunnel of these categories, read\n[`AppliedAdr::tunnel_enforcement`] for what was actually applied."

Previous value: -"Canonical ADR tunnel restriction code applied (\"B/D\", \"(—)\", …),\nor null when no code was declared."New value: +"Canonical ADR tunnel restriction code applied (\"B/D\", \"(-)\", …),\nor null when no code was declared."

Previous value: -"The engine costing-option fields these words became, e.g.\n`{\"use_tolls\": 0.0, \"exclude_ferries\": true}`. This is the whole of\nwhat was sent — there is no hidden second mechanism."New value: +"The engine costing-option fields these words became, e.g.\n`{\"use_tolls\": 0.0, \"exclude_ferries\": true}`. This is the whole of\nwhat was sent, there is no hidden second mechanism."

Previous value: -"The declared value for the field (null for \"combined\"). NOTE: for\ntruck this is the vehicle's dimension, not the infrastructure\nlimit — the physical restriction is not identified."New value: +"The declared value for the field (null for \"combined\"). NOTE: for\ntruck this is the vehicle's dimension, not the infrastructure\nlimit, the physical restriction is not identified."

Previous value: -"The same manoeuvre anchored to a recognisable place, e.g. \"Turn\nright just after the Shell garage\" — present only when the request\nset `landmarks: true` and a place near the junction cleared the\nsalience bar. Prefer reading this aloud when it is there: it is how\na passenger would give the direction. `instruction` is always the\nengine's own and is never replaced."New value: +"The same manoeuvre anchored to a recognisable place, e.g. \"Turn\nright just after the Shell garage\", present only when the request\nset `landmarks: true` and a place near the junction cleared the\nsalience bar. Prefer reading this aloud when it is there: it is how\na passenger would give the direction. `instruction` is always the\nengine's own and is never replaced."

Previous value: -"Why the route goes the way it does — the `route` tool's opt-in\nrationale block, computed for truck, auto, bicycle, pedestrian and\nmotor_scooter costings. **Method honesty:** the routing engine exposes\nno exclusion set, so entries are derived by re-routing with each\ndeclared constraint or preference relaxed\n(`basis: \"route_divergence\"`); this proves a field was binding and\nwhere, but never names the physical restriction or feature (the\nspecific signed bridge, hill or unlit street). No live traffic or\nincident data enters the comparison and no delay is ever estimated\nfrom one — the engine has no live speed field."New value: +"Why the route goes the way it does, the `route` tool's opt-in\nrationale block, computed for truck, auto, bicycle, pedestrian and\nmotor_scooter costings. **Method honesty:** the routing engine exposes\nno exclusion set, so entries are derived by re-routing with each\ndeclared constraint or preference relaxed\n(`basis: \"route_divergence\"`); this proves a field was binding and\nwhere, but never names the physical restriction or feature (the\nspecific signed bridge, hill or unlit street). No live traffic or\nincident data enters the comparison and no delay is ever estimated\nfrom one, the engine has no live speed field."

Previous value: -"How the declared ADR tunnel code reaches the routing engine, and what a\nreturned route therefore does — and does not — prove.\n\nThis block exists because [`AppliedAdr::forbidden_tunnel_categories`] is\na statement about the **load** (ADR 8.6.4 applied to the declared code),\nand on its own it reads like a statement about the **route**. It is not\none. The engine excludes a road only where the routing graph records an\nADR tunnel category for it, and that category is derived from OSM\n`hazmat:*` tagging. Coverage is therefore uneven: a corridor with no\nsuch tagging is not excluded and looks, in the response, exactly like a\ncorridor that was checked and cleared.\n\nThe field is emitted on every `applied_adr`, so a caller can never\nreceive the categories without the boundary that qualifies them."New value: +"How the declared ADR tunnel code reaches the routing engine, and what a\nreturned route therefore does (and does not) prove.\n\nThis block exists because [`AppliedAdr::forbidden_tunnel_categories`] is\na statement about the **load** (ADR 8.6.4 applied to the declared code),\nand on its own it reads like a statement about the **route**. It is not\none. The engine excludes a road only where the routing graph records an\nADR tunnel category for it, and that category is derived from OSM\n`hazmat:*` tagging. Coverage is therefore uneven: a corridor with no\nsuch tagging is not excluded and looks, in the response, exactly like a\ncorridor that was checked and cleared.\n\nThe field is emitted on every `applied_adr`, so a caller can never\nreceive the categories without the boundary that qualifies them."

Previous value: -"Clean-air / low-emission zones this route enters and what the\ndeclared vehicle pays in each, with the publishing authority cited\n(only when `emissions` was declared). Passed through verbatim from\nthe gateway's curated dataset — the same figures `GET /v1/zones`\npublishes, so a charge can always be audited back to its source."New value: +"Clean-air / low-emission zones this route enters and what the\ndeclared vehicle pays in each, with the publishing authority cited\n(only when `emissions` was declared). Passed through verbatim from\nthe gateway's curated dataset, the same figures `GET /v1/zones`\npublishes, so a charge can always be audited back to its source."

Added value: +{
+  "description": "A mapmap.ai link that draws this route on a map: open it or pass it\non as the last line of the answer. Nothing is stored server-side and\nopening it needs no key; the link itself carries the stop coordinates\nand stop names (plus any arrival clocks, dwell times and totals) and\nnothing else, so anyone holding it can read those stops. Absent when\nthe plan cannot be linked (see `view_url_note`) or the server runs\nwith links turned off (`SN_MCP_SITE_URL` empty).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Why there is no `view_url` (too many vehicles or stops for one link,\nor over the 6,000 character cap), or what the link left out to fit\nunder the cap (arrival times, dwell times, then stop names). Relay it\nwith the link.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Pedestrian options for costing \"pedestrian\": lit-street preference,\naccessibility type and hiking difficulty, mapped onto Valhalla\n`costing_options.pedestrian`. All preferences, never guarantees — the\nrouter prefers matching ways where the map data supports it."New value: +"Pedestrian options for costing \"pedestrian\": lit-street preference,\npedestrian type, hills, surface quality and hiking difficulty, mapped\nonto Valhalla `costing_options.pedestrian` (surface quality and the\ngrade cap are MapMap gateway fields). All preferences, never\nguarantees: the router prefers matching ways where the map data\nsupports it."

Added value: +{
+  "description": "Maximum grade in whole percent, 1–90. Needs the MapMap gateway:\nthe routing engine accepts this cap but does not enforce it yet,\nand the gateway's `grade.cap` says so on every route that sets it.",
+  "format": "uint32",
+  "minimum": 0,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Surface quality for wheelchair routes: \"avoid\" (the default where\nthe deployment has a surface graph covering the route) or \"ignore\"\n(use the ordinary graph). Wheelchair only, and needs the MapMap\ngateway; the `surface_quality` block in the output says whether it\nwas applied.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Pedestrian type: \"wheelchair\" (avoids steps, kerbs and steep\ngrades where mapped) or \"blind\" (richer guidance detail). Omit for\nthe default on-foot profile."New value: +"Pedestrian type: \"wheelchair\" (avoids mapped steps and kerbs and\nthe rougher surface classes; hills per `use_hills`) or \"blind\"\n(richer guidance detail). Omit for the default on-foot profile."

Added value: +{
+  "description": "Willingness to take hills, 0.0–1.0 (0.0 = avoid climbs as strongly\nas the engine can; the engine default is 0.5). A preference, not a\ncap. The MapMap gateway sends 0.0 on a wheelchair route that does\nnot set it, and reports that in `grade.preference`.",
+  "format": "double",
+  "type": [
+    "number",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The hill report on a pedestrian route (only through the MapMap\ngateway): maximum grade, total ascent and descent sampled along\nthe route from the elevation model, the hill preference sent, and\nwhether a requested grade cap was enforced. Relay `cap.enforced`\nand the caveat as given."
+}

Added value: +{
+  "description": "Surface quality on a wheelchair route (only through the MapMap\ngateway): `applied` true with the region, the exact rule, the data\ntimestamp and a caveat when the route was computed on the surface\ngraph; `applied` false with a `reason` otherwise. Relay the caveat:\nit is a preference from OpenStreetMap ratings where they exist,\nand says nothing about kerbs, widths, steps or inclines."
+}

Added value: +{
+  "description": "ISO 3166-1 alpha-2 country of the road the manoeuvre starts on, e.g.\n`\"GB\"`. This and the road fields below come from the MapMap gateway's\nroad walk: present when the route was computed through the gateway\n(GATEWAY_URL + GATEWAY_API_KEY) and the map knows the road, absent\notherwise. Never inferred.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The side of the road traffic keeps to there, `\"left\"` or `\"right\"`;\npresent only when the road's country is known.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Route numbers of that road (`\"; \"` separated, e.g. `\"A27\"` or\n`\"I 5; US 101\"`); absent when it carries none, never read from a\nstreet name.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Engine road class of that road (`motorway`, `trunk`, `primary`,\n`secondary`, `tertiary`, `unclassified`, `residential`,\n`service_other`).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The posted limit as the sign shows it, in the road's own unit:\n`{\"type\":\"known\",\"value\":30,\"unit\":\"mph\"}` (plus `\"national\":true`\nfor a national limit), `{\"type\":\"unlimited\"}` or `{\"type\":\"unknown\"}`.\nRead from the road the manoeuvre mostly travels along."
+}

Added value: +{
+  "description": "The speed-limit sign family there: `\"vienna\"` (roundel) or\n`\"mutcd\"` (US and Canadian rectangle).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The unit speed limits are posted in on that road, `\"mph\"` or\n`\"km/h\"`, from its country (never from the request's units).",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "ISO 3166-2 subdivision of that road where the map carries one, e.g.\n`\"GB-ENG\"` or `\"US-CA\"`.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +[
+  {
+    "properties": {
+      "lat": {
+        "description": "Latitude in decimal degrees (−90 to 90).",
+        "format": "double",
+        "type": "number"
+      },
+      "lon": {
+        "description": "Longitude in decimal degrees (−180 to 180).",
+        "format": "double",
+        "type": "number"
+      }
+    },
+    "required": [
+      "lat",
+      "lon"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "GeoJSON position [lon, lat]: longitude FIRST.",
+    "items": {
+      "format": "double",
+      "type": "number"
+    },
+    "maxItems": 2,
+    "minItems": 2,
+    "type": "array"
+  }
+]

Removed value: -{
-  "description": "Latitude in decimal degrees (−90 to 90).",
-  "format": "double",
-  "type": "number"
-}

Removed value: -{
-  "description": "Longitude in decimal degrees (−180 to 180).",
-  "format": "double",
-  "type": "number"
-}

Removed value: -[
-  "lat",
-  "lon"
-]

Added value: +[
+  {
+    "properties": {
+      "lat": {
+        "description": "Latitude in decimal degrees (−90 to 90).",
+        "format": "double",
+        "type": "number"
+      },
+      "lon": {
+        "description": "Longitude in decimal degrees (−180 to 180).",
+        "format": "double",
+        "type": "number"
+      }
+    },
+    "required": [
+      "lat",
+      "lon"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "GeoJSON position [lon, lat]: longitude FIRST.",
+    "items": {
+      "format": "double",
+      "type": "number"
+    },
+    "maxItems": 2,
+    "minItems": 2,
+    "type": "array"
+  }
+]

Previous value: -"A WGS84 coordinate pair in decimal degrees."New value: +"A WGS84 coordinate in decimal degrees: a {lat, lon} object (preferred), or a GeoJSON [lon, lat] array with LONGITUDE FIRST, the same order as every polygon field on this server."

Removed value: -{
-  "lat": {
-    "description": "Latitude in decimal degrees (−90 to 90).",
-    "format": "double",
-    "type": "number"
-  },
-  "lon": {
-    "description": "Longitude in decimal degrees (−180 to 180).",
-    "format": "double",
-    "type": "number"
-  }
-}

Removed value: -[
-  "lat",
-  "lon"
-]

Removed value: -"object"

Added value: +{
+  "description": "Ask whether there is a prettier way (default false, `auto`\ncosting only). The route in `geometry_polyline6` is NEVER swapped:\nwhat comes back is a peer offer beside it, in `scenic`, carrying\nthe plain sentence that justifies it. No sentence, no offer: a\nroute that scores well but cannot support one is dropped rather\nthan dressed up, and `scenic.reason` is then null, which is an\nanswer. Every candidate that lost says why in\n`scenic.rejections[]` (`same_route`, `no_scenic_gain`,\n`not_scenic_enough`, `over_time_budget`, `nothing_to_say`), so\n\"no prettier way\" is always attributable. Opt-in because it\ncosts: at most two extra metered route computations, the same\nbilling shape as `rationale`. Needs the MapMap gateway, whose\nbasemap archive the scoring is measured against.",
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Added value: +{
+  "description": "The scenic assessment beside a route: a peer offer, never a\nsubstitution.\n\nThe fields here are the ones a client must actually read before\nsaying anything. `block` keeps the gateway's whole answer beside them\nso a figure can always be audited back to the source that produced\nit, rather than to this mapping.",
+  "properties": {
+    "alternative_geometry_polyline6": {
+      "description": "The scenic route's own geometry, polyline6, when there is one to\noffer. `geometry_polyline6` on the route itself is byte-for-byte\nwhat the same request returns without the flag.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "available": {
+      "description": "Whether scenery could be assessed at all on this deployment. When\nfalse, `note` says why and nothing below was measured: that is\n\"we could not look\", never \"there is nothing there\".",
+      "type": "boolean"
+    },
+    "block": {
+      "description": "The gateway's whole `scenic` block, verbatim: candidates, feature\nshares, tile coverage, metering and budget."
+    },
+    "caveats": {
+      "description": "The standing limits of the method, for relaying to users.",
+      "type": "string"
+    },
+    "chosen": {
+      "description": "Which route the assessment would offer: `\"fastest\"` (the quick way\nis already the pretty one, or nothing beat it) or `\"scenic\"`.",
+      "type": "string"
+    },
+    "extra_time_s": {
+      "description": "How much longer the offered route takes than the fastest one,\nseconds, and the sentence for it. Absent when nothing was offered.",
+      "format": "double",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "note": {
+      "description": "Why no assessment ran (only when `available` is false).",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "reason": {
+      "description": "The plain, speakable sentence behind the offer. **Null is an\nanswer**: nothing on this corridor measured above the floor, so\nno claim is made rather than one being invented.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "rejections": {
+      "description": "Why each candidate that lost lost. Empty when none did. Relay it:\nit is what makes \"no prettier way\" an attributable answer instead\nof a shrug.",
+      "items": {
+        "$ref": "#/$defs/ScenicRejection"
+      },
+      "type": "array"
+    },
+    "spoken": {
+      "description": "The trade phrased for speech, e.g. \"About seven minutes longer\nthan the quick way.\" Prefer reading this aloud over the seconds.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "available",
+    "chosen",
+    "caveats",
+    "block"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Why one candidate route was not offered.",
+  "properties": {
+    "code": {
+      "description": "The rejection code: `same_route`, `no_scenic_gain`,\n`not_scenic_enough`, `over_time_budget` or `nothing_to_say`.",
+      "type": "string"
+    },
+    "detail": {
+      "description": "The code in words, including the minutes an `over_time_budget`\ncandidate would have cost, so raising the budget is an informed\nchoice rather than a guess.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Where the candidate came from: `\"fastest\"`, `\"engine_alternate\"`\nor `\"no_motorway\"`.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "code",
+    "detail"
+  ],
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ScenicOffer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The scenic peer offer (only when `scenic: true` was requested):\nwhether there is a prettier way, the sentence that justifies it,\nwhat the detour costs, and why every candidate that lost lost.\nThe route above is never swapped for it."
+}

Added value: +{
+  "description": "A road feature to avoid as a PREFERENCE, not a ban. \"tolls\" and \"highways\" apply to motorised costings only (auto, truck, bus, motor_scooter, motorcycle); \"ferries\" applies to every costing. Asking for one on a costing whose engine table has no field for it is refused rather than silently ignored.",
+  "enum": [
+    "tolls",
+    "highways",
+    "ferries"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "What a vehicle burns, in clean-air-zone scheme terms.",
+  "oneOf": [
+    {
+      "const": "petrol",
+      "description": "Petrol, including petrol hybrids (schemes rate a hybrid by its\ncombustion engine's approval).",
+      "type": "string"
+    },
+    {
+      "const": "diesel",
+      "description": "Diesel, including diesel hybrids.",
+      "type": "string"
+    },
+    {
+      "const": "electric",
+      "description": "Battery-electric.",
+      "type": "string"
+    },
+    {
+      "const": "hydrogen",
+      "description": "Hydrogen fuel cell.",
+      "type": "string"
+    },
+    {
+      "const": "gas",
+      "description": "LPG or CNG; rated as petrol by every scheme in the dataset.",
+      "type": "string"
+    }
+  ]
+}

Added value: +{
+  "description": "A vehicle's emission declaration, for clean-air / low-emission zone\nassessment.",
+  "properties": {
+    "euro_standard": {
+      "description": "Its Euro emission standard, 1–6. Heavy-duty approvals are written\nin Roman numerals (Euro VI); declare Euro VI as `6`. Required for\nany combustion fuel — without it no zone can be resolved, and a\nhalf-declared vehicle is indistinguishable from an undeclared one.\nOptional only for `electric` or `hydrogen`.",
+      "format": "uint8",
+      "maximum": 255,
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "fuel": {
+      "$ref": "#/$defs/EmissionsFuel",
+      "description": "What it burns."
+    },
+    "vehicle_category": {
+      "$ref": "#/$defs/EmissionsVehicleCategory",
+      "description": "What kind of vehicle this is, in scheme terms."
+    }
+  },
+  "required": [
+    "vehicle_category",
+    "fuel"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "What a vehicle is, in clean-air-zone scheme terms.\n\nDeclaring this turns \"charge depends on vehicle emissions\" into an\nanswer. Without it a zone can only be named, never priced.",
+  "oneOf": [
+    {
+      "const": "car",
+      "description": "A private car.",
+      "type": "string"
+    },
+    {
+      "const": "van",
+      "description": "A van or light goods vehicle up to 3.5 tonnes.",
+      "type": "string"
+    },
+    {
+      "const": "minibus",
+      "description": "A minibus (typically 8+ passenger seats, up to 5 tonnes).",
+      "type": "string"
+    },
+    {
+      "const": "hgv",
+      "description": "A heavy goods vehicle over 3.5 tonnes.",
+      "type": "string"
+    },
+    {
+      "const": "bus",
+      "description": "A bus over 5 tonnes.",
+      "type": "string"
+    },
+    {
+      "const": "coach",
+      "description": "A coach over 5 tonnes.",
+      "type": "string"
+    },
+    {
+      "const": "taxi",
+      "description": "A licensed hackney carriage.",
+      "type": "string"
+    },
+    {
+      "const": "phv",
+      "description": "A private hire vehicle.",
+      "type": "string"
+    },
+    {
+      "const": "motorcycle",
+      "description": "A motorcycle, moped or tricycle.",
+      "type": "string"
+    },
+    {
+      "const": "motorhome",
+      "description": "A motor caravan or campervan.",
+      "type": "string"
+    }
+  ]
+}

Added value: +{
+  "description": "A road feature to exclude outright. A hard exclusion can leave a request with no path at all — that is the honest answer, not a failure — and it depends on the routing engine's own hard-exclusion setting, which nothing here can read.",
+  "enum": [
+    "tolls",
+    "highways",
+    "ferries",
+    "bridges",
+    "tunnels"
+  ],
+  "type": "string"
+}

Removed value: -{
-  "description": "A WGS84 coordinate pair in decimal degrees.",
-  "properties": {
-    "lat": {
-      "description": "Latitude in decimal degrees (−90 to 90).",
-      "format": "double",
-      "type": "number"
-    },
-    "lon": {
-      "description": "Longitude in decimal degrees (−180 to 180).",
-      "format": "double",
-      "type": "number"
-    }
-  },
-  "required": [
-    "lat",
-    "lon"
-  ],
-  "type": "object"
-}

Added value: +{
+  "description": "Side-of-street preference for arriving at or departing from a location.\n\nCarries both vocabularies: MapMap's own `same`/`opposite`/`either` and\nthe OSRM/Mapbox `approaches` words `curb`/`unrestricted`, which are\naliases for `same` and `either`. Both spell the same request, on this\nsurface and on the HTTP API.",
+  "oneOf": [
+    {
+      "const": "same",
+      "description": "The side the location itself projects to — the kerb, resolved\nagainst the locale's driving side (the left kerb in the UK, the\nright in Germany).",
+      "type": "string"
+    },
+    {
+      "const": "opposite",
+      "description": "The far side of the road from the location.",
+      "type": "string"
+    },
+    {
+      "const": "either",
+      "description": "No side preference.",
+      "type": "string"
+    },
+    {
+      "const": "curb",
+      "description": "Alias for `same`, from the OSRM/Mapbox `approaches` vocabulary.",
+      "type": "string"
+    },
+    {
+      "const": "unrestricted",
+      "description": "Alias for `either`, from the OSRM/Mapbox `approaches` vocabulary.",
+      "type": "string"
+    }
+  ]
+}

Added value: +{
+  "description": "One location of a `route` request: a coordinate, plus the optional\nkerbside approach for arriving at it.\n\nA bare `{lat, lon}` is still a complete location — every kerbside field\nis optional and omitting all of them is exactly the request that was\nmade before they existed.",
+  "properties": {
+    "lat": {
+      "description": "Latitude in decimal degrees (−90 to 90).",
+      "format": "double",
+      "type": "number"
+    },
+    "lon": {
+      "description": "Longitude in decimal degrees (−180 to 180).",
+      "format": "double",
+      "type": "number"
+    },
+    "preferred_side": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/PreferredSideKind"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Which side of the street to arrive on (or depart from). `same` (or\n`curb`) puts the vehicle on the door's side of the road, resolved\nagainst the locale's driving side. Two honest limits: this is a\n**snapping preference**, not a manoeuvre guarantee — the engine\nprefers an edge on that side, it does not promise the driver never\ncrosses — and it needs a coordinate genuinely offset from the road\ncentreline, because a point on the centreline has no side."
+    },
+    "street_side_max_distance_m": {
+      "description": "Metres: further than this from the road centreline, the side of\nstreet is treated as `none` and `preferred_side` does nothing.\nEngine default 1000 m. Together with `street_side_tolerance_m` this\nis a WINDOW: a pair that leaves no window (tolerance at or above\nmax distance) is refused here rather than answered with a route on\nwhich the kerbside preference was silently inert.",
+      "format": "uint32",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "street_side_tolerance_m": {
+      "description": "Metres: nearer than this to the road centreline, the side of street\nis treated as `none` and `preferred_side` does nothing. Engine\ndefault 5 m.",
+      "format": "uint32",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "lat",
+    "lon"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Road features to avoid as a PREFERENCE. Rendered as the costing's\nwillingness factor set to zero — a thumb on the scale, not a ban.\nThe engine's own reference is explicit that a value of zero is not\nguaranteed to avoid the feature entirely, and it does not: asking\nto avoid tolls across the Dartford Crossing returns the same tolled\nroute, because the untolled alternative is fifty kilometres\nfurther. Use `exclude` when you mean a ban.",
+  "items": {
+    "$ref": "#/$defs/AvoidFeature"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

Previous value: -"#/$defs/LatLon"New value: +"#/$defs/RouteLocation"

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/EmissionsSpec"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The vehicle's emission declaration, for UK clean-air / low-emission\nzone assessment. Given, the response's `zones` block names every\nzone the route enters and what THIS vehicle pays there, with the\npublishing authority cited. Without it a zone can only be named,\nnever priced. Needs the MapMap gateway, which holds the curated\nzone dataset; the full dataset is readable at `GET /v1/zones`."
+}

Added value: +{
+  "description": "Road features to exclude outright, rendered as the costing's hard\nexclusion flag. Two things follow from that and both matter: a hard\nexclusion can return NO ROUTE rather than a detour (excluding\ntunnels on a Rotherhithe crossing has no answer), and the flags\ndepend on the routing engine's `allow_hard_exclusions` setting,\nwhich the engine does not expose and nothing here can read — so\nthis is never promised, only requested.",
+  "items": {
+    "$ref": "#/$defs/ExcludeFeature"
+  },
+  "type": [
+    "array",
+    "null"
+  ]
+}

Previous value: -"#/$defs/LatLon"New value: +"#/$defs/RouteLocation"

Previous value: -"#/$defs/LatLon"New value: +"#/$defs/RouteLocation"

Added value: +{
+  "description": "What the avoidance lists actually did, reported back so a 200 is never\nreadable as a certificate.",
+  "properties": {
+    "avoid": {
+      "description": "The `avoid` values that were applied, echoed back.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "caveats": {
+      "description": "The caveats that apply to this request, in words fit to repeat to a\nuser. Always present when anything was applied.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "costing_option_fields": {
+      "description": "The engine costing-option fields these words became, e.g.\n`{\"use_tolls\": 0.0, \"exclude_ferries\": true}`. This is the whole of\nwhat was sent — there is no hidden second mechanism."
+    },
+    "exclude": {
+      "description": "The `exclude` values that were applied, echoed back.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "costing_option_fields",
+    "caveats"
+  ],
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/AppliedAvoidance"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "What `avoid`/`exclude` became, and the caveats that go with it\n(only when either list carried something)."
+}

Added value: +{
+  "description": "Clean-air / low-emission zones this route enters and what the\ndeclared vehicle pays in each, with the publishing authority cited\n(only when `emissions` was declared). Passed through verbatim from\nthe gateway's curated dataset — the same figures `GET /v1/zones`\npublishes, so a charge can always be audited back to its source."
+}