{
  "name": "supercarto-compile",
  "description": "hosted compile of the supercarto maplet pipeline: real map data in, a token-budgeted topological graph out. Same conventions as the local HTTP API in src/server/http.ts.",
  "attribution": "© OpenStreetMap contributors (ODbL)",
  "routes": [
    "GET|POST /maplet?lat=&lon=&radiusM=&budget=&layers=&format=yaml|json",
    "GET /scr?bbox=w,s,e,n&layers=",
    "GET /daylight?lat=&lon=&at=",
    "GET /weather?lat=&lon=&hours=",
    "GET /terrain?lat=&lon=&radiusM=&samples=",
    "GET /healthz"
  ],
  "unavailable": [
    {
      "route": "/transit",
      "because": "a schedule needs an operator-imported GTFS feed read from the local filesystem; a Worker has no filesystem, so transit is absent rather than served as \"no service\""
    },
    {
      "route": "tool get_traffic",
      "because": "live traffic needs a licensed flow provider credential (TomTom or HERE); hosted mode ships none, and free-flow numbers presented as live conditions are the failure this library refuses to make"
    },
    {
      "route": "indoor floor plans",
      "because": "indoor floor plans are local files: no filesystem here, so indoor layers are absent rather than fabricated"
    }
  ],
  "fallback": {
    "data": "when Overpass refuses this deployment egress (HTTP 521 from every known instance), /maplet and /scr compile from a hosted PMTiles extract of the planet built from OpenStreetMap. The extract detail level is coarse beyond z10-ish, so a city block here is zoom-level honest about what zoom it shipped: the map document carries `source: protomaps` when the fallback served it, and its own truncation warnings when it stopped early.",
    "health": "/healthz probes Overpass only; a 503 here does not mean /maplet is down - the PMTiles fallback answers from the archive instead."
  }
}