POST/v1/errands/plan

{
  "arrival": "2026-11-05T21:14:53Z",
  "arrive_by": "2026-11-06T15:15:00Z",
  "attribution": "Place data © OpenStreetMap contributors, ODbL.",
  "costing": "auto",
  "departure": "2026-11-05T20:42:13Z",
  "errands": [
    {
      "candidates_costed": 6,
      "candidates_in_corridor": 25,
      "category": "pharmacy",
      "dwell_s": 360,
      "excluded_closed": 1,
      "id": "prescription",
      "kind": "category",
      "matched_categories": [
        "pharmacy"
      ]
    },
    {
      "candidates_costed": 6,
      "candidates_in_corridor": 20,
      "category": "petrol station",
      "dwell_s": 300,
      "excluded_closed": 0,
      "id": "petrol",
      "kind": "category",
      "matched_categories": [
        "fuel"
      ]
    }
  ],
  "eta_calibration": {
    "applied": true,
    "cells_calibrated": 179,
    "cells_not_walked": 0,
    "cells_unchanged": 17,
    "method": "gb_typical_delay_v1",
    "note": "Local roads in Great Britain carry no live traffic data, so the time on them includes the junction and congestion delay a typical car meets at this time of day, from Department for Transport statistics, on top of the routing engine's free-flowing time: the same delay POST /route adds, applied to the path each cell was costed on. It is a typical figure, not live traffic. Motorways, roads covered by National Highways traffic data and roads outside Great Britain keep the engine's own time.",
    "period": "all_day",
    "sources": [
      "Department for Transport, tables CGN0503 and CGN0504: average speed and delay on local 'A' roads in England, urban and rural, by time of day, rolling year to June 2026"
    ]
  },
  "feasible": true,
  "geometry_polyline6": "}ij}_BtxqGhBTvEh@vFx@cAfSlFzBr@ZbM~Dh@lFj@YnIxBtPjGfPvFjDlApAj@",
  "opening_hours": {
    "candidates_costed": 12,
    "candidates_with_a_tag": 4,
    "clock_change_possible_from": "2026-11-06T01:00:00Z",
    "coverage_note": "Opening hours come from OpenStreetMap's `opening_hours` tag, which most places do not carry: on a British sample of the production index taken on 21 September 2026, 41 % of places carried one at all. A stop with no usable tag is planned and flagged, never quietly treated as open.",
    "evaluated_in_offset": "+00:00",
    "policy": "A stop the map's opening-hours tag proves shut at the time you would arrive is dropped and the chain re-solved. No stop is ever reported as known-open: `open_on_the_tag` means the tag covers your arrival time, which is evidence and not a promise.",
    "stops_closed_on_the_tag": 0,
    "stops_excluded_as_closed": 1,
    "stops_open_on_the_tag": 0,
    "stops_with_no_usable_tag": 2
  },
  "plan": {
    "final_leg": {
      "distance_m": 4114,
      "drive_s": 443.6
    },
    "stops": [
      {
        "arrive": "2026-11-05T20:55:47Z",
        "category": "petrol station",
        "depart": "2026-11-05T21:00:47Z",
        "distance_m": 5927,
        "drive_s": 814.2,
        "dwell_s": 300,
        "errand": "petrol",
        "hours": {
          "message": "The map carries no usable opening hours for this place, so the plan does not know whether it is open when you would arrive.",
          "source": "OpenStreetMap opening_hours tag, as held in this deployment's place index",
          "tag": null,
          "verdict": "unknown"
        },
        "kind": "category",
        "place": {
          "id": "osm:w608512509:poi",
          "label": "Valero, Falmer Road, Brighton, Knepp Wildland, United Kingdom",
          "lat": 50.83624867030552,
          "lon": -0.07496869883366994,
          "name": "Valero",
          "off_route_m": 70,
          "source": "index",
          "type": "fuel"
        }
      },
      {
        "arrive": "2026-11-05T21:01:29Z",
        "category": "pharmacy",
        "depart": "2026-11-05T21:07:29Z",
        "distance_m": 268,
        "drive_s": 41.5,
        "dwell_s": 360,
        "errand": "prescription",
        "hours": {
          "message": "The map carries no usable opening hours for this place, so the plan does not know whether it is open when you would arrive.",
          "source": "OpenStreetMap opening_hours tag, as held in this deployment's place index",
          "tag": null,
          "verdict": "unknown"
        },
        "kind": "category",
        "place": {
          "id": "osm:w1387527988:poi",
          "label": "Well Pharmacy, Warren Way 13, BN2 6PH, Brighton, Knepp Wildland, United Kingdom",
          "lat": 50.837354278564455,
          "lon": -0.07435394078493118,
          "name": "Well Pharmacy",
          "off_route_m": 63.8,
          "source": "index",
          "type": "pharmacy"
        }
      }
    ],
    "total_distance_m": 10309,
    "total_drive_s": 1299.3,
    "total_duration_s": 1959.3,
    "total_dwell_s": 660
  },
  "search": {
    "candidates_costed": 12,
    "category_radius_m": 15000,
    "corridor_max_detour_minutes": 12,
    "note": "Candidates come from the corridor of the direct route. A place further off it than the corridor allows was never considered, so an empty or infeasible answer is a statement about this corridor and this index, never about what exists on the ground.",
    "per_errand_cap": 6,
    "sample_points": 9,
    "total_cap": 24
  },
  "slack_s": 64806.9,
  "usage": "Plan before setting off, or let a passenger do it. Stating a request like this is not something a driver can do at the wheel: handheld phone use while driving has carried six points in Great Britain since March 2022, and the offence covers operating an app.",
  "verification": "Every stop is either a place held in this deployment's map index, with its id, or a coordinate you supplied. No place in this response was generated, and every time came from the routing engine."
}