From f8eb1915fef8ebf64ba40dafe2b83bdc8cb81c73 Mon Sep 17 00:00:00 2001 From: Maurice Date: Mon, 20 Apr 2026 22:09:19 +0200 Subject: [PATCH] fix(map): render transport reservations on Mapbox GL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ReservationOverlay was Leaflet-only: react-leaflet components, L.divIcon, panes, useMap/useMapEvents. When the user switched the planner map to Mapbox GL, the entire feature disappeared — no polylines, no endpoint badges, no clickable IATA labels. Add a matching overlay for the Mapbox renderer: - New reservationsMapbox.ts with an imperative `ReservationMapboxOverlay` class — mapbox-gl is imperative, so a React component wrapper would fight its own lifecycle every render. The manager owns one GeoJSON source + line layer for the arcs, one HTML `mapboxgl.Marker` per endpoint badge, and one per flight stats label. It cleans itself up when the map is rebuilt (style/token/3d toggle) or unmounted. - Geometry helpers (great-circle arc, antimeridian split, haversine, tz-aware duration math, label formatting) are copied from the Leaflet overlay so both renderers produce the same lines. Great-circle is useful even on the Mapbox globe because the mercator projection mode still draws the short-way line, and the antimeridian split prevents a NYC↔Tokyo flight from wrapping halfway around the planet. - Flights / cruises get geodesic arcs; trains / cars get straight lines. All four types get clickable endpoint badges with the matching lucide icon; only flights render the rotating mid-arc stats label (IATA → IATA · distance · duration) — same rule as the Leaflet overlay. - The stats label's rotation is recomputed on every `render` event by projecting two points straddling the arc midpoint, which keeps it parallel to the arc as the camera rotates/zooms on the globe. - Visibility thresholds mirror the Leaflet overlay (per-type min pixel distance before a line / endpoint label is worth drawing). - MapViewGL now accepts the `reservations`, `visibleConnectionIds`, `showReservationStats`, `onReservationClick` props that the Leaflet MapView already took. `visibleConnectionIds` is honoured the same way — the per-booking toggle in DayPlanSidebar controls which routes appear, so switching the renderer doesn't lose that UX. - Added a `mapReady` gate so the overlay can only add its source/layer once the map's `load` handler has attached the other trip sources; the gate resets on every style rebuild. --- client/src/components/Map/MapViewGL.tsx | 62 ++- .../src/components/Map/reservationsMapbox.ts | 388 ++++++++++++++++++ 2 files changed, 449 insertions(+), 1 deletion(-) create mode 100644 client/src/components/Map/reservationsMapbox.ts diff --git a/client/src/components/Map/MapViewGL.tsx b/client/src/components/Map/MapViewGL.tsx index 1a2a0ca0..72919b6c 100644 --- a/client/src/components/Map/MapViewGL.tsx +++ b/client/src/components/Map/MapViewGL.tsx @@ -8,9 +8,10 @@ import { getCached, isLoading, fetchPhoto, onThumbReady, getAllThumbs } from '.. import { CATEGORY_ICON_MAP } from '../shared/categoryIcons' import { isStandardFamily, supportsCustom3d, wantsTerrain, addCustom3dBuildings, addTerrainAndSky } from './mapboxSetup' import { attachLocationMarker, type LocationMarkerHandle } from './locationMarkerMapbox' +import { ReservationMapboxOverlay } from './reservationsMapbox' import LocationButton from './LocationButton' import { useGeolocation } from '../../hooks/useGeolocation' -import type { Place } from '../../types' +import type { Place, Reservation } from '../../types' function categoryIconSvg(iconName: string | null | undefined, size: number): string { const IconComponent = (iconName && CATEGORY_ICON_MAP[iconName]) || CATEGORY_ICON_MAP['MapPin'] @@ -44,6 +45,10 @@ interface Props { rightWidth?: number hasInspector?: boolean hasDayDetail?: boolean + reservations?: Reservation[] + visibleConnectionIds?: number[] + showReservationStats?: boolean + onReservationClick?: (reservationId: number) => void } function createMarkerElement(place: Place & { category_color?: string; category_icon?: string }, photoUrl: string | null, orderNumbers: number[] | null, selected: boolean): HTMLDivElement { @@ -139,17 +144,28 @@ export function MapViewGL({ rightWidth = 0, hasInspector = false, hasDayDetail = false, + reservations = [], + visibleConnectionIds = [], + showReservationStats = false, + onReservationClick, }: Props) { const mapboxStyle = useSettingsStore(s => s.settings.mapbox_style || 'mapbox://styles/mapbox/standard') const mapboxToken = useSettingsStore(s => s.settings.mapbox_access_token || '') const mapbox3d = useSettingsStore(s => s.settings.mapbox_3d_enabled !== false) const mapboxQuality = useSettingsStore(s => s.settings.mapbox_quality_mode === true) + const showEndpointLabels = useSettingsStore(s => s.settings.map_booking_labels) !== false const placesPhotosEnabled = useAuthStore(s => s.placesPhotosEnabled) const [photoUrls, setPhotoUrls] = useState>(getAllThumbs) + const [mapReady, setMapReady] = useState(false) const containerRef = useRef(null) const mapRef = useRef(null) const markersRef = useRef>(new Map()) const locationMarkerRef = useRef(null) + const reservationOverlayRef = useRef(null) + // Refs so the reservation overlay always sees the latest callback / + // options without forcing a full overlay rebuild on every prop change. + const onReservationClickRef = useRef(onReservationClick) + onReservationClickRef.current = onReservationClick const { position: userPosition, mode: trackingMode, error: trackingError, cycleMode: cycleTrackingMode, setMode: setTrackingMode } = useGeolocation() const onClickRefs = useRef({ marker: onMarkerClick, map: onMapClick, context: onMapContextMenu }) onClickRefs.current.marker = onMarkerClick @@ -228,6 +244,10 @@ export function MapViewGL({ layout: { 'line-cap': 'round', 'line-join': 'round' }, }) } + // Signal that sources/layers are attached so overlay effects can + // safely add their own sources. Style rebuilds reset this via the + // cleanup below. + setMapReady(true) }) map.on('click', (e) => { @@ -299,12 +319,17 @@ export function MapViewGL({ canvas.removeEventListener('auxclick', onAuxClick) markersRef.current.forEach(m => m.remove()) markersRef.current.clear() + if (reservationOverlayRef.current) { + reservationOverlayRef.current.destroy() + reservationOverlayRef.current = null + } if (locationMarkerRef.current) { locationMarkerRef.current.destroy() locationMarkerRef.current = null } try { map.remove() } catch { /* noop */ } mapRef.current = null + setMapReady(false) } }, [mapboxStyle, mapboxToken, mapbox3d]) // rebuild on style changes only @@ -434,6 +459,41 @@ export function MapViewGL({ src.setData({ type: 'FeatureCollection', features }) }, [places]) + // Reservation overlay — mirrors the Leaflet ReservationOverlay: great- + // circle arcs for flights/cruises, straight lines for trains/cars, + // clickable endpoint badges, rotating mid-arc stats label for flights. + // The overlay is a small imperative manager that owns its own source, + // layer, and HTML markers; it lives next to the map for the map's + // lifetime and is rebuilt when the style/token/3d effect rebuilds. + // + // `visibleConnectionIds` is driven by the per-reservation toggle in + // DayPlanSidebar — nothing is rendered until the user enables a + // booking's route, matching the Leaflet MapView's behaviour. + const visibleReservations = useMemo(() => { + if (!visibleConnectionIds || visibleConnectionIds.length === 0) return [] + const set = new Set(visibleConnectionIds) + return reservations.filter(r => set.has(r.id)) + }, [reservations, visibleConnectionIds]) + + useEffect(() => { + const map = mapRef.current + if (!map || !mapReady) return + if (!reservationOverlayRef.current) { + reservationOverlayRef.current = new ReservationMapboxOverlay(map, { + showConnections: true, + showStats: showReservationStats, + showEndpointLabels, + onEndpointClick: (id) => onReservationClickRef.current?.(id), + }) + } + reservationOverlayRef.current.update(visibleReservations, { + showConnections: true, + showStats: showReservationStats, + showEndpointLabels, + onEndpointClick: (id) => onReservationClickRef.current?.(id), + }) + }, [visibleReservations, showReservationStats, showEndpointLabels, mapReady]) + // Fit bounds on fitKey change — matches the Leaflet BoundsController const paddingOpts = useMemo(() => { const isMobile = typeof window !== 'undefined' && window.innerWidth < 768 diff --git a/client/src/components/Map/reservationsMapbox.ts b/client/src/components/Map/reservationsMapbox.ts new file mode 100644 index 00000000..8c44ab03 --- /dev/null +++ b/client/src/components/Map/reservationsMapbox.ts @@ -0,0 +1,388 @@ +// Mapbox GL counterpart to ReservationOverlay.tsx. +// +// react-leaflet is component-driven, mapbox-gl is imperative — so instead of +// a React component, this exports a small manager class the MapViewGL wires +// up next to its other sources/layers. The geometry logic (great-circle arcs, +// antimeridian split, duration math) mirrors the Leaflet overlay so both +// renderers produce the same visual result on the globe or a flat projection. + +import { createElement } from 'react' +import { renderToStaticMarkup } from 'react-dom/server' +import mapboxgl from 'mapbox-gl' +import { Plane, Train, Ship, Car } from 'lucide-react' +import type { Reservation, ReservationEndpoint } from '../../types' + +export const RESERVATION_SOURCE_ID = 'trek-reservations' +export const RESERVATION_LINE_LAYER_ID = 'trek-reservations-lines' + +type TransportType = 'flight' | 'train' | 'cruise' | 'car' +const TRANSPORT_TYPES: TransportType[] = ['flight', 'train', 'cruise', 'car'] +const TRANSPORT_COLOR = '#3b82f6' + +const TYPE_META: Record = { + flight: { icon: Plane, geodesic: true }, + train: { icon: Train, geodesic: false }, + cruise: { icon: Ship, geodesic: true }, + car: { icon: Car, geodesic: false }, +} + +// ── geometry helpers (ported from ReservationOverlay.tsx) ──────────────── +const toRad = (d: number) => d * Math.PI / 180 +const toDeg = (r: number) => r * 180 / Math.PI + +function greatCircle(a: [number, number], b: [number, number], steps = 256): [number, number][] { + const [lat1, lng1] = [toRad(a[0]), toRad(a[1])] + const [lat2, lng2] = [toRad(b[0]), toRad(b[1])] + const d = 2 * Math.asin(Math.sqrt(Math.sin((lat2 - lat1) / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin((lng2 - lng1) / 2) ** 2)) + if (d === 0) return [a, b] + const pts: [number, number][] = [] + for (let i = 0; i <= steps; i++) { + const f = i / steps + const A = Math.sin((1 - f) * d) / Math.sin(d) + const B = Math.sin(f * d) / Math.sin(d) + const x = A * Math.cos(lat1) * Math.cos(lng1) + B * Math.cos(lat2) * Math.cos(lng2) + const y = A * Math.cos(lat1) * Math.sin(lng1) + B * Math.cos(lat2) * Math.sin(lng2) + const z = A * Math.sin(lat1) + B * Math.sin(lat2) + const lat = Math.atan2(z, Math.sqrt(x * x + y * y)) + const lng = Math.atan2(y, x) + pts.push([toDeg(lat), toDeg(lng)]) + } + return pts +} + +function splitAntimeridian(points: [number, number][]): [number, number][][] { + const segments: [number, number][][] = [] + let cur: [number, number][] = [] + for (let i = 0; i < points.length; i++) { + if (i > 0 && Math.abs(points[i][1] - points[i - 1][1]) > 180) { + if (cur.length > 1) segments.push(cur) + cur = [] + } + cur.push(points[i]) + } + if (cur.length > 1) segments.push(cur) + return segments +} + +function haversineKm(a: [number, number], b: [number, number]): number { + const R = 6371 + const dLat = toRad(b[0] - a[0]) + const dLng = toRad(b[1] - a[1]) + const h = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(a[0])) * Math.cos(toRad(b[0])) * Math.sin(dLng / 2) ** 2 + return 2 * R * Math.asin(Math.sqrt(h)) +} + +function parseInTz(isoLocal: string, tz: string): number { + const [datePart, timePart] = isoLocal.split('T') + const [y, mo, d] = datePart.split('-').map(Number) + const [h, mi] = (timePart || '00:00').split(':').map(Number) + const guess = Date.UTC(y, mo - 1, d, h, mi) + const fmt = new Intl.DateTimeFormat('en-US', { + timeZone: tz, hour12: false, + year: 'numeric', month: '2-digit', day: '2-digit', + hour: '2-digit', minute: '2-digit', second: '2-digit', + }) + const parts = Object.fromEntries(fmt.formatToParts(new Date(guess)).filter(p => p.type !== 'literal').map(p => [p.type, p.value])) + const asUtc = Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day), Number(parts.hour) % 24, Number(parts.minute), Number(parts.second)) + return guess - (asUtc - guess) +} + +function computeDuration(from: ReservationEndpoint, to: ReservationEndpoint, fallbackStart: string | null, fallbackEnd: string | null): string | null { + let start = from.local_date && from.local_time ? `${from.local_date}T${from.local_time}` : fallbackStart + let end = to.local_date && to.local_time ? `${to.local_date}T${to.local_time}` : fallbackEnd + if (!start || !end) return null + if (!start.includes('T') && end.includes('T')) start = `${end.split('T')[0]}T${start}` + if (!end.includes('T') && start.includes('T')) end = `${start.split('T')[0]}T${end}` + if (!start.includes('T') || !end.includes('T')) return null + const fromTz = from.timezone || to.timezone + const toTz = to.timezone || fromTz + let startMs: number, endMs: number + if (fromTz && toTz) { + startMs = parseInTz(start, fromTz) + endMs = parseInTz(end, toTz) + } else { + startMs = new Date(start).getTime() + endMs = new Date(end).getTime() + } + if (!Number.isFinite(startMs) || !Number.isFinite(endMs)) return null + if (endMs <= startMs) endMs += 24 * 60 * 60000 + const minutes = Math.round((endMs - startMs) / 60000) + if (minutes <= 0 || minutes > 48 * 60) return null + const h = Math.floor(minutes / 60) + const m = minutes % 60 + return h > 0 ? `${h}h ${m}m` : `${m}m` +} + +const cleanName = (name: string) => name.replace(/\s*\([^)]*\)/g, '').trim() + +// ── item building ───────────────────────────────────────────────────────── +interface TransportItem { + res: Reservation + from: ReservationEndpoint + to: ReservationEndpoint + type: TransportType + arcs: [number, number][][] + primaryArc: [number, number][] + mainLabel: string | null + subLabel: string | null +} + +function buildItems(reservations: Reservation[]): TransportItem[] { + const out: TransportItem[] = [] + for (const r of reservations) { + if (!TRANSPORT_TYPES.includes(r.type as TransportType)) continue + const eps = r.endpoints || [] + const from = eps.find(e => e.role === 'from') + const to = eps.find(e => e.role === 'to') + if (!from || !to) continue + const type = r.type as TransportType + const isGeo = TYPE_META[type].geodesic + const arcs = isGeo + ? splitAntimeridian(greatCircle([from.lat, from.lng], [to.lat, to.lng])) + : [[[from.lat, from.lng], [to.lat, to.lng]] as [number, number][]] + const primaryIdx = arcs.reduce((best, seg, idx, all) => seg.length > all[best].length ? idx : best, 0) + const primaryArc = arcs[primaryIdx] ?? [] + const duration = computeDuration(from, to, r.reservation_time || null, r.reservation_end_time || null) + const distance = `${Math.round(haversineKm([from.lat, from.lng], [to.lat, to.lng]))} km` + const mainLabel = from.code && to.code ? `${from.code} → ${to.code}` : null + const subParts = [duration, distance].filter(Boolean) as string[] + const subLabel = subParts.length > 0 ? subParts.join(' · ') : null + out.push({ res: r, from, to, type, arcs, primaryArc, mainLabel, subLabel }) + } + return out +} + +// ── DOM helpers for HTML markers ────────────────────────────────────────── +function endpointMarkerHtml(type: TransportType, label: string | null): string { + const { icon: IconCmp } = TYPE_META[type] + const svg = renderToStaticMarkup(createElement(IconCmp, { size: 13, color: 'white', strokeWidth: 2.5 })) + const labelHtml = label ? `${label}` : '' + return `
${svg}${labelHtml}
` +} + +function buildStatsHtml(mainLabel: string | null, subLabel: string | null): { html: string; width: number; height: number } { + const estWidth = Math.max( + mainLabel ? mainLabel.length * 6.5 : 0, + subLabel ? subLabel.length * 5.5 : 0, + ) + 22 + const hasBoth = !!mainLabel && !!subLabel + const height = hasBoth ? 36 : 22 + const main = mainLabel ? `${mainLabel}` : '' + const sub = subLabel ? `${subLabel}` : '' + const html = `
${main}${sub}
` + return { html, width: estWidth, height } +} + +// ── overlay manager ────────────────────────────────────────────────────── +export interface ReservationOverlayOptions { + showConnections: boolean + showStats: boolean + showEndpointLabels: boolean + onEndpointClick?: (reservationId: number) => void +} + +export class ReservationMapboxOverlay { + private map: mapboxgl.Map + private items: TransportItem[] = [] + private opts: ReservationOverlayOptions + private endpointMarkers: mapboxgl.Marker[] = [] + private statsMarkers: { marker: mapboxgl.Marker; arc: [number, number][] }[] = [] + private rerender: () => void + private destroyed = false + + constructor(map: mapboxgl.Map, opts: ReservationOverlayOptions) { + this.map = map + this.opts = opts + this.rerender = () => { if (!this.destroyed) this.render() } + this.setupLayer() + map.on('zoomend', this.rerender) + map.on('moveend', this.rerender) + map.on('render', this.updateStatsRotation) + } + + update(reservations: Reservation[], opts: ReservationOverlayOptions) { + this.opts = opts + this.items = buildItems(reservations) + this.render() + } + + destroy() { + this.destroyed = true + this.map.off('zoomend', this.rerender) + this.map.off('moveend', this.rerender) + this.map.off('render', this.updateStatsRotation) + this.endpointMarkers.forEach(m => m.remove()) + this.endpointMarkers = [] + this.statsMarkers.forEach(s => s.marker.remove()) + this.statsMarkers = [] + try { + if (this.map.getLayer(RESERVATION_LINE_LAYER_ID)) this.map.removeLayer(RESERVATION_LINE_LAYER_ID) + if (this.map.getSource(RESERVATION_SOURCE_ID)) this.map.removeSource(RESERVATION_SOURCE_ID) + } catch { /* map already gone */ } + } + + private setupLayer() { + const map = this.map + if (map.getSource(RESERVATION_SOURCE_ID)) return + map.addSource(RESERVATION_SOURCE_ID, { type: 'geojson', data: { type: 'FeatureCollection', features: [] } }) + map.addLayer({ + id: RESERVATION_LINE_LAYER_ID, + type: 'line', + source: RESERVATION_SOURCE_ID, + paint: { + 'line-color': TRANSPORT_COLOR, + 'line-width': 2.5, + // Confirmed = solid + 0.75; pending = dashed + 0.55. + 'line-opacity': ['case', ['==', ['get', 'status'], 'confirmed'], 0.75, 0.55] as any, + 'line-dasharray': ['case', ['==', ['get', 'status'], 'confirmed'], ['literal', [1, 0]], ['literal', [3, 3]]] as any, + }, + layout: { 'line-cap': 'round', 'line-join': 'round' }, + }) + } + + private render() { + const map = this.map + if (!this.map.getSource(RESERVATION_SOURCE_ID)) return + + const show = this.opts.showConnections + + // Visible filter: require the on-screen pixel distance between + // endpoints to exceed a type-specific minimum, same as the Leaflet + // overlay, so tiny no-op transport lines don't clutter the map. + const visibleItems = show ? this.items.filter(item => { + try { + const fromPx = map.project([item.from.lng, item.from.lat]) + const toPx = map.project([item.to.lng, item.to.lat]) + const dx = fromPx.x - toPx.x, dy = fromPx.y - toPx.y + const dist = Math.sqrt(dx * dx + dy * dy) + const minPx = item.type === 'flight' ? 50 : item.type === 'cruise' ? 150 : item.type === 'car' ? 80 : 200 + return dist >= minPx + } catch { return true } + }) : [] + + // Label visibility threshold is higher than line visibility, to keep + // endpoint text from overlapping on very short lines. + const labelVisibleIds = new Set() + if (show) { + for (const item of visibleItems) { + try { + const fromPx = map.project([item.from.lng, item.from.lat]) + const toPx = map.project([item.to.lng, item.to.lat]) + const dx = fromPx.x - toPx.x, dy = fromPx.y - toPx.y + const dist = Math.sqrt(dx * dx + dy * dy) + const minPx = item.type === 'flight' ? 50 : item.type === 'cruise' ? 300 : item.type === 'car' ? 150 : 400 + if (dist >= minPx) labelVisibleIds.add(item.res.id) + } catch { /* ignore */ } + } + } + + // ── line features ─────────────────────────────────────────────── + const features = visibleItems.flatMap(item => item.arcs.map(seg => ({ + type: 'Feature' as const, + properties: { + resId: item.res.id, + type: item.type, + status: item.res.status ?? 'pending', + }, + geometry: { + type: 'LineString' as const, + coordinates: seg.map(([lat, lng]) => [lng, lat]), + }, + }))) + const src = map.getSource(RESERVATION_SOURCE_ID) as mapboxgl.GeoJSONSource | undefined + src?.setData({ type: 'FeatureCollection', features }) + + // ── endpoint markers ──────────────────────────────────────────── + this.endpointMarkers.forEach(m => m.remove()) + this.endpointMarkers = [] + if (show) { + for (const item of visibleItems) { + const showLabel = this.opts.showEndpointLabels && labelVisibleIds.has(item.res.id) + for (const ep of [item.from, item.to]) { + const label = showLabel ? (ep.code || cleanName(ep.name)) : null + const el = document.createElement('div') + el.innerHTML = endpointMarkerHtml(item.type, label) + const inner = el.firstElementChild as HTMLElement | null + const node = inner ?? el + node.title = ep.name || '' + if (this.opts.onEndpointClick) { + node.addEventListener('click', (ev) => { + ev.stopPropagation() + this.opts.onEndpointClick?.(item.res.id) + }) + } + const marker = new mapboxgl.Marker({ element: node, anchor: 'center' }) + .setLngLat([ep.lng, ep.lat]) + .addTo(map) + this.endpointMarkers.push(marker) + } + } + } + + // ── stats label (flights only) ────────────────────────────────── + this.statsMarkers.forEach(s => s.marker.remove()) + this.statsMarkers = [] + if (show && this.opts.showStats) { + for (const item of visibleItems) { + if (item.type !== 'flight') continue + if (!labelVisibleIds.has(item.res.id)) continue + if (!item.mainLabel && !item.subLabel) continue + const arc = item.primaryArc + if (arc.length < 2) continue + const mid = arc[Math.floor(arc.length / 2)]! + const { html, width, height } = buildStatsHtml(item.mainLabel, item.subLabel) + const el = document.createElement('div') + el.style.cssText = `width:${width}px;height:${height}px;pointer-events:none;` + el.innerHTML = html + const marker = new mapboxgl.Marker({ element: el, anchor: 'center' }) + .setLngLat([mid[1], mid[0]]) + .addTo(map) + this.statsMarkers.push({ marker, arc }) + } + } + // Prime rotation once so labels don't flash horizontal on first paint. + this.updateStatsRotation() + } + + // Match the Leaflet overlay's "rotate the label along the arc" look. + // We pick a short segment straddling the arc midpoint, measure the + // screen angle between those two projected points, and clamp it to + // [-90°, 90°] so text never renders upside-down. + private updateStatsRotation = () => { + if (this.destroyed) return + for (const entry of this.statsMarkers) { + const { marker, arc } = entry + if (arc.length < 2) continue + const midIdx = Math.floor(arc.length / 2) + const a = arc[Math.max(0, midIdx - 2)]! + const b = arc[Math.min(arc.length - 1, midIdx + 2)]! + try { + const pa = this.map.project([a[1], a[0]]) + const pb = this.map.project([b[1], b[0]]) + let angle = Math.atan2(pb.y - pa.y, pb.x - pa.x) * 180 / Math.PI + if (angle > 90) angle -= 180 + if (angle < -90) angle += 180 + const el = marker.getElement() + const inner = el.querySelector('.trek-stats-inner') as HTMLElement | null + if (inner) inner.style.transform = `rotate(${angle}deg)` + } catch { /* map not ready / projection failure */ } + } + } +}