import { PbfReader } from 'pbf'; import { VectorTile } from '@mapbox/vector-tile'; /** * @file TomTom traffic-flow vector-tile client: fetch + MVT decode. * * Fetches flow tiles from the local `/api/tomtom/flow/{z}/{x}/{y}.pbf` proxy * (the TomTom key never reaches the browser) and decodes the Mapbox Vector * Tile layer "Traffic flow" into plain lon/lat polylines with congestion * attributes. Consumed by the traffic layer's live mode * for matching congestion onto OpenStreetMap roads. * * Segment shape: `{coords: [[lon,lat],…], trafficLevel: 0..1, roadType: string, * closure: boolean}` — `trafficLevel` is TomTom's current/free-flow speed * ratio (1 = free flow). Features with a missing/non-finite `traffic_level` * are skipped unless `road_closure` is true (closures decode with level 0). * * Deps: `pbf@5` (PbfReader) + `@mapbox/vector-tile@3` — both tiny and * tree-shakeable; decoding happens client-side so the proxy stays a dumb * binary cache. * * @module layers/traffic/flowDecode */ const FLOW_LAYER_NAME = 'Traffic flow'; /** Decode flow geometry; strict mode distinguishes damaged tiles from valid empty coverage. */ export function decodeFlowTile(data, z, x, y, { strict = false } = {}) { let layer; try { const bytes = data instanceof ArrayBuffer ? new Uint8Array(data) : data; const tile = new VectorTile(new PbfReader(bytes)); layer = tile.layers[FLOW_LAYER_NAME]; } catch { if (strict) throw new Error('Malformed TomTom flow tile'); return []; } if (!layer) return []; const segments = []; for (let i = 0; i < layer.length; i++) { let feature; let geometry; try { feature = layer.feature(i); geometry = feature.toGeoJSON(x, y, z).geometry; } catch { continue; // one malformed feature must not drop the tile } const props = feature.properties || {}; const closure = props.road_closure === true || props.road_closure === 'true'; const rawLevel = props.traffic_level; const hasLevel = typeof rawLevel === 'number' && Number.isFinite(rawLevel); // Skip features we can't color — unless closed (closures render dot-free // regardless of level, so they stay useful without one). if (!hasLevel && !closure) continue; const trafficLevel = hasLevel ? Math.min(1, Math.max(0, rawLevel)) : 0; const roadType = typeof props.road_type === 'string' ? props.road_type : ''; const lines = geometry.type === 'LineString' ? [geometry.coordinates] : geometry.type === 'MultiLineString' ? geometry.coordinates : []; for (const coords of lines) { if (!Array.isArray(coords) || coords.length < 2) continue; segments.push({ coords, trafficLevel, roadType, roadCategory: props.road_category ?? null, roadSubcategory: props.road_subcategory ?? null, closure, coverage: props.traffic_road_coverage ?? null, leftHandTraffic: props.left_hand_traffic === true || props.left_hand_traffic === 'true', }); } } return segments; }