openskidata-format 11.0.0 → 12.0.0

package/dist/Lift.d.ts

@@ -5,6 +5,7 @@ import { SkiAreaSummaryFeature } from './SkiArea';
 import { Source } from './Source';
 import { LiftStationSpotFeature } from './Spot';
 import { Status } from './Status';
+import { ViewportHint } from './ViewportHint';
 export type LiftFeature = GeoJSON.Feature<LiftGeometry, LiftProperties>;
 export type LiftGeometry = GeoJSON.LineString | GeoJSON.MultiLineString;
 /**
@@ -72,6 +73,7 @@ export type LiftProperties = {
     websites: string[];
     wikidataID: string | null;
     places: Place[];
+    viewportHint: ViewportHint;
 };
 export declare enum LiftType {
     CableCar = "cable_car",

package/dist/Lift.js

@@ -4,7 +4,10 @@ exports.LiftType = void 0;
 exports.getLiftElevationData = getLiftElevationData;
 exports.getFormattedLiftType = getFormattedLiftType;
 exports.getLiftColor = getLiftColor;
+const tslib_1 = require("tslib");
+const distance_1 = tslib_1.__importDefault(require("@turf/distance"));
 const ElevationProfile_1 = require("./ElevationProfile");
+const Spot_1 = require("./Spot");
 const Status_1 = require("./Status");
 const exhaustiveMatchingGuard_1 = require("./util/exhaustiveMatchingGuard");
 var LiftType;
@@ -31,16 +34,37 @@ function getLiftElevationData(feature) {
     }
     const elevationData = (0, ElevationProfile_1.getElevationData)(geometry);
     const durationInSeconds = feature.properties.duration;
+    const terminalDistances = getTerminalStationDistances(feature);
+    const inclinedLength = terminalDistances?.inclinedLengthInMeters ??
+        elevationData.inclinedLengthInMeters;
+    const verticalLength = terminalDistances?.verticalInMeters ?? elevationData.verticalInMeters;
     return {
         ...elevationData,
         speedInMetersPerSecond: durationInSeconds
-            ? elevationData.inclinedLengthInMeters / durationInSeconds
+            ? inclinedLength / durationInSeconds
             : null,
         verticalSpeedInMetersPerSecond: durationInSeconds
-            ? elevationData.verticalInMeters / durationInSeconds
+            ? verticalLength / durationInSeconds
             : null,
     };
 }
+function getTerminalStationDistances(feature) {
+    const stations = feature.properties.stations;
+    const topStation = stations.find((s) => s.properties.position === Spot_1.LiftStationPosition.Top);
+    const bottomStation = stations.find((s) => s.properties.position === Spot_1.LiftStationPosition.Bottom);
+    if (!topStation || !bottomStation) {
+        return null;
+    }
+    const topCoords = topStation.geometry.coordinates;
+    const bottomCoords = bottomStation.geometry.coordinates;
+    if (topCoords.length < 3 || bottomCoords.length < 3) {
+        return null;
+    }
+    const horizontalDistanceInMeters = (0, distance_1.default)(topStation.geometry, bottomStation.geometry, { units: 'meters' });
+    const verticalInMeters = Math.abs(topCoords[2] - bottomCoords[2]);
+    const inclinedLengthInMeters = Math.sqrt(Math.pow(horizontalDistanceInMeters, 2) + Math.pow(verticalInMeters, 2));
+    return { inclinedLengthInMeters, verticalInMeters };
+}
 function getFormattedLiftType(liftType) {
     switch (liftType) {
         case LiftType.CableCar:

package/dist/Lift.js.map

@@ -1 +1 @@
-{"version":3,"file":"Lift.js","sourceRoot":"","sources":["../src/Lift.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Lift.js","sourceRoot":"","sources":["../src/Lift.ts"],"names":[],"mappings":"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"}

package/dist/Run.d.ts

@@ -7,6 +7,7 @@ import { SkiAreaSummaryFeature } from './SkiArea';
 import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
+import { ViewportHint } from './ViewportHint';
 export type RunGeometry = GeoJSON.LineString | GeoJSON.Polygon;
 /**
  * Represents a segment of a ski run/trail.
@@ -79,6 +80,7 @@ export type RunProperties = {
     wikidataID: string | null;
     places: Place[];
     snowCoverHistory?: SnowCoverHistory;
+    viewportHint: ViewportHint;
 };
 export declare enum RunUse {
     Downhill = "downhill",

package/dist/Run.js.map

@@ -1 +1 @@
-{"version":3,"file":"Run.js","sourceRoot":"","sources":["../src/Run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Run.js","sourceRoot":"","sources":["../src/Run.ts"],"names":[],"mappings":"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"}

package/dist/SkiArea.d.ts

@@ -6,6 +6,7 @@ import { RunDifficultyConvention } from './RunDifficultyConvention';
 import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
+import { ViewportHint } from './ViewportHint';
 /**
  * A ski area feature is derived from several sources:
  * - OpenStreetMap site=piste relations (must contain at least one lift or run of any kind)
@@ -48,6 +49,7 @@ export type SkiAreaProperties = SkiAreaSummaryProperties & {
     websites: string[];
     wikidataID: string | null;
     places: Place[];
+    viewportHint: ViewportHint;
 };
 export type SkiAreaSummaryProperties = {
     type: FeatureType.SkiArea;

package/dist/SkiArea.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAsEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}
+{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAwEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/dist/Spot.d.ts

@@ -3,6 +3,7 @@ import { FeatureType } from './FeatureType';
 import { Place } from './Place';
 import { SkiAreaSummaryFeature } from './SkiArea';
 import { Source } from './Source';
+import { ViewportHint } from './ViewportHint';
 /**
  * A GeoJSON feature representing a spot (point of interest) in or around a ski area.
  *
@@ -30,6 +31,7 @@ export type SpotBaseProperties = {
     skiAreas: SkiAreaSummaryFeature[];
     sources: Source[];
     places: Place[];
+    viewportHint: ViewportHint;
 };
 /**
  * Types of spots that can be found in or around ski areas.

package/dist/Spot.js.map

@@ -1 +1 @@
-{"version":3,"file":"Spot.js","sourceRoot":"","sources":["../src/Spot.ts"],"names":[],"mappings":";;;AA+CA;;GAEG;AACH,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,wCAA4B,CAAA;IAC5B,2EAA+D,CAAA;IAC/D,+EAAmE,CAAA;IACnE,iCAAqB,CAAA;AACvB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAaD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,gCAAS,CAAA;IACT,8CAAuB,CAAA;AACzB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAuBD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,kCAAW,CAAA;IACX,wCAAiB,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B"}
+{"version":3,"file":"Spot.js","sourceRoot":"","sources":["../src/Spot.ts"],"names":[],"mappings":";;;AAiDA;;GAEG;AACH,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,wCAA4B,CAAA;IAC5B,2EAA+D,CAAA;IAC/D,+EAAmE,CAAA;IACnE,iCAAqB,CAAA;AACvB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAaD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,gCAAS,CAAA;IACT,8CAAuB,CAAA;AACzB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAuBD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,kCAAW,CAAA;IACX,wCAAiB,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B"}

package/dist/ViewportHint.d.ts

@@ -0,0 +1,33 @@
+import * as GeoJSON from 'geojson';
+/**
+ * Pre-computed viewport positioning data stored on every feature's properties.
+ * Camera space: Y axis points uphill (along bearing), X axis points screen-right.
+ * Metric values are in that rotated frame with elevation-adjusted Y positions
+ * (at 45° pitch, Δe metres above mean elevation shifts Y by Δe metres).
+ */
+export type ViewportHint = {
+    /** Geographic centre of the rotated bounding box as [lng, lat]. */
+    center: [number, number];
+    /**
+     * Uphill bearing in degrees clockwise from north. null when elevation variation is
+     * insufficient to determine orientation — client should use top-down view (pitch 0, bearing 0).
+     */
+    bearing: number | null;
+    /** Bounding box width along the camera X axis, in metres. */
+    rotatedWidthMeters: number;
+    /** Bounding box height along the camera Y axis, in metres (elevation-adjusted). */
+    rotatedHeightMeters: number;
+    /**
+     * Most-downhill edge of the elevation-adjusted bounding box in camera-Y metres, relative
+     * to mean feature elevation. Used to compute the perspective centre shift at 45° pitch:
+     * look-at point = minCameraY + nearFraction * rotatedHeightMeters, where
+     * nearFraction = nearGround / (nearGround + farGround) from camera pitch and vFOV.
+     */
+    minCameraY: number;
+};
+/**
+ * Computes a ViewportHint from one or more GeoJSON geometries.
+ * All geometry types are accepted; elevation is read from the Z coordinate (defaults to 0).
+ * Throws if no coordinates are found.
+ */
+export declare function computeViewportHint(geometries: GeoJSON.Geometry[]): ViewportHint;

package/dist/ViewportHint.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeViewportHint = computeViewportHint;
+const tslib_1 = require("tslib");
+const distance_1 = tslib_1.__importDefault(require("@turf/distance"));
+/**
+ * Computes a ViewportHint from one or more GeoJSON geometries.
+ * All geometry types are accepted; elevation is read from the Z coordinate (defaults to 0).
+ * Throws if no coordinates are found.
+ */
+function computeViewportHint(geometries) {
+    // Collect all coordinates (for bbox + elevation stats) and consecutive segment pairs
+    // (for the downhill bearing calculation).
+    const allCoords = [];
+    const bearingSegments = [];
+    for (const geom of geometries) {
+        collectGeometry(geom, allCoords, bearingSegments);
+    }
+    if (allCoords.length === 0)
+        throw new Error('computeViewportHint: no coordinates found in provided geometries');
+    let minLng = Infinity, maxLng = -Infinity;
+    let minLat = Infinity, maxLat = -Infinity;
+    for (const [lng, lat] of allCoords) {
+        if (lng < minLng)
+            minLng = lng;
+        if (lng > maxLng)
+            maxLng = lng;
+        if (lat < minLat)
+            minLat = lat;
+        if (lat > maxLat)
+            maxLat = lat;
+    }
+    const centerLng = (minLng + maxLng) / 2;
+    const centerLat = (minLat + maxLat) / 2;
+    // Weight each segment's downhill direction by length to find dominant bearing.
+    let sumSin = 0, sumCos = 0;
+    for (const [[lng0, lat0, elev0], [lng1, lat1, elev1]] of bearingSegments) {
+        if (elev0 === elev1)
+            continue;
+        const [fromLng, fromLat, toLng, toLat] = elev0 > elev1
+            ? [lng0, lat0, lng1, lat1]
+            : [lng1, lat1, lng0, lat0];
+        const bear = greatCircleBearing(fromLat, fromLng, toLat, toLng);
+        const len = (0, distance_1.default)([lng0, lat0], [lng1, lat1], { units: 'meters' });
+        const bearingRad = (bear * Math.PI) / 180;
+        sumSin += Math.sin(bearingRad) * len;
+        sumCos += Math.cos(bearingRad) * len;
+    }
+    // Uphill bearing = downhill + 180°; null if no elevation variation found.
+    let mapBearing = null;
+    if (sumSin !== 0 || sumCos !== 0) {
+        const dominantDownhill = (Math.atan2(sumSin, sumCos) * 180) / Math.PI;
+        const normalizedDownhill = ((dominantDownhill % 360) + 360) % 360;
+        mapBearing = (normalizedDownhill + 180) % 360;
+    }
+    const metersPerDeg = 111320;
+    const cosLat = Math.cos(centerLat * (Math.PI / 180));
+    const bearingRad = ((mapBearing ?? 0) * Math.PI) / 180;
+    let elevationSum = 0;
+    for (const [, , elev] of allCoords)
+        elevationSum += elev;
+    const meanElevation = elevationSum / allCoords.length;
+    let minCameraX = Infinity, maxCameraX = -Infinity;
+    let minCameraY = Infinity, maxCameraY = -Infinity;
+    for (const [lng, lat, elev] of allCoords) {
+        const dx = (lng - centerLng) * cosLat * metersPerDeg;
+        const dy = (lat - centerLat) * metersPerDeg;
+        const cx = dx * Math.cos(bearingRad) - dy * Math.sin(bearingRad);
+        const cy = dx * Math.sin(bearingRad) + dy * Math.cos(bearingRad);
+        // At 45° pitch, elevation above mean shifts apparent Y by the same amount (tan 45° = 1).
+        const cyEffective = cy + (elev - meanElevation);
+        if (cx < minCameraX)
+            minCameraX = cx;
+        if (cx > maxCameraX)
+            maxCameraX = cx;
+        if (cyEffective < minCameraY)
+            minCameraY = cyEffective;
+        if (cyEffective > maxCameraY)
+            maxCameraY = cyEffective;
+    }
+    return {
+        center: [centerLng, centerLat],
+        bearing: mapBearing,
+        rotatedWidthMeters: maxCameraX - minCameraX,
+        rotatedHeightMeters: maxCameraY - minCameraY,
+        minCameraY,
+    };
+}
+/** Recursively extracts coordinates and segment pairs from a geometry. */
+function collectGeometry(geom, allCoords, bearingSegments) {
+    switch (geom.type) {
+        case 'Point': {
+            const [lng, lat, elev = 0] = geom.coordinates;
+            allCoords.push([lng, lat, elev]);
+            break;
+        }
+        case 'MultiPoint': {
+            for (const pos of geom.coordinates) {
+                const [lng, lat, elev = 0] = pos;
+                allCoords.push([lng, lat, elev]);
+            }
+            break;
+        }
+        case 'LineString':
+            collectPositions(geom.coordinates, allCoords, bearingSegments);
+            break;
+        case 'MultiLineString':
+            for (const line of geom.coordinates) {
+                collectPositions(line, allCoords, bearingSegments);
+            }
+            break;
+        case 'Polygon':
+            for (const ring of geom.coordinates) {
+                collectPositions(ring, allCoords, bearingSegments);
+            }
+            break;
+        case 'MultiPolygon':
+            for (const polygon of geom.coordinates) {
+                for (const ring of polygon) {
+                    collectPositions(ring, allCoords, bearingSegments);
+                }
+            }
+            break;
+        case 'GeometryCollection':
+            for (const g of geom.geometries) {
+                collectGeometry(g, allCoords, bearingSegments);
+            }
+            break;
+    }
+}
+/** Adds positions to allCoords and consecutive pairs to bearingSegments. Z defaults to 0. */
+function collectPositions(positions, allCoords, bearingSegments) {
+    const elevated = positions.map(([lng, lat, elev = 0]) => [lng, lat, elev]);
+    for (const coord of elevated)
+        allCoords.push(coord);
+    for (let i = 0; i < elevated.length - 1; i++) {
+        bearingSegments.push([elevated[i], elevated[i + 1]]);
+    }
+}
+/** Great-circle bearing from (lat1, lng1) to (lat2, lng2), in degrees 0–360. */
+function greatCircleBearing(lat1, lng1, lat2, lng2) {
+    const toRad = (d) => (d * Math.PI) / 180;
+    const φ1 = toRad(lat1);
+    const φ2 = toRad(lat2);
+    const Δλ = toRad(lng2 - lng1);
+    const y = Math.sin(Δλ) * Math.cos(φ2);
+    const x = Math.cos(φ1) * Math.sin(φ2) - Math.sin(φ1) * Math.cos(φ2) * Math.cos(Δλ);
+    return ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;
+}
+//# sourceMappingURL=ViewportHint.js.map

package/dist/ViewportHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewportHint.js","sourceRoot":"","sources":["../src/ViewportHint.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * from './SnowCoverHistory';
 export * from './Source';
 export * from './Spot';
 export * from './Status';
+export * from './ViewportHint';

package/dist/index.js

@@ -14,4 +14,5 @@ tslib_1.__exportStar(require("./SnowCoverHistory"), exports);
 tslib_1.__exportStar(require("./Source"), exports);
 tslib_1.__exportStar(require("./Spot"), exports);
 tslib_1.__exportStar(require("./Status"), exports);
+tslib_1.__exportStar(require("./ViewportHint"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,kDAAuB;AACvB,gDAAqB;AACrB,oEAAyC;AACzC,8DAAmC;AACnC,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,iDAAsB;AACtB,mDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,kDAAuB;AACvB,gDAAqB;AACrB,oEAAyC;AACzC,8DAAmC;AACnC,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,iDAAsB;AACtB,mDAAwB;AACxB,yDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openskidata-format",
-  "version": "11.0.0",
+  "version": "12.0.0",
   "description": "Data format for OpenSkiMap.org",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/Lift.test.ts

@@ -1,7 +1,175 @@
-import { LiftType, getFormattedLiftType, getLiftColor } from './Lift';
+import { FeatureType } from './FeatureType';
+import { getLiftElevationData, LiftFeature, LiftType, getFormattedLiftType, getLiftColor } from './Lift';
+import { LiftStationPosition, LiftStationSpotFeature, SpotType } from './Spot';
 import { Status } from './Status';
 
+function makeLiftFeature(overrides: {
+  coordinates?: GeoJSON.Position[];
+  duration?: number | null;
+  stations?: LiftStationSpotFeature[];
+}): LiftFeature {
+  return {
+    type: 'Feature',
+    geometry: {
+      type: 'LineString',
+      coordinates: overrides.coordinates ?? [
+        [8.0, 46.0, 1000],
+        [8.01, 46.05, 1500],
+      ],
+    },
+    properties: {
+      type: FeatureType.Lift,
+      id: 'test',
+      liftType: LiftType.ChairLift,
+      status: Status.Operating,
+      access: null,
+      name: null,
+      ref: null,
+      refFRCAIRN: null,
+      description: null,
+      oneway: null,
+      occupancy: null,
+      capacity: null,
+      duration: overrides.duration !== undefined ? overrides.duration : 600,
+      detachable: null,
+      bubble: null,
+      heating: null,
+      tunnel: null,
+      stations: overrides.stations ?? [],
+      skiAreas: [],
+      sources: [],
+      websites: [],
+      wikidataID: null,
+      places: [],
+    },
+  }
+}
+
+function makeStation(
+  position: LiftStationPosition,
+  coordinates: GeoJSON.Position,
+): LiftStationSpotFeature {
+  return {
+    type: 'Feature',
+    geometry: { type: 'Point', coordinates },
+    properties: {
+      type: FeatureType.Spot,
+      id: `station-${position}`,
+      spotType: SpotType.LiftStation,
+      name: null,
+      position,
+      entry: null,
+      exit: null,
+      liftId: 'test',
+      skiAreas: [],
+      sources: [],
+      places: [],
+    },
+  }
+}
+
 describe('Lift', () => {
+  describe('getLiftElevationData', () => {
+    it('returns null for non-LineString geometry', () => {
+      const feature: LiftFeature = {
+        ...makeLiftFeature({}),
+        geometry: { type: 'MultiLineString', coordinates: [] },
+      }
+      expect(getLiftElevationData(feature)).toBeNull()
+    })
+
+    it('returns null when coordinates have no elevation', () => {
+      const feature = makeLiftFeature({
+        coordinates: [[8.0, 46.0], [8.01, 46.05]],
+      })
+      expect(getLiftElevationData(feature)).toBeNull()
+    })
+
+    it('returns null speed when duration is null', () => {
+      const result = getLiftElevationData(makeLiftFeature({ duration: null }))
+      expect(result?.speedInMetersPerSecond).toBeNull()
+      expect(result?.verticalSpeedInMetersPerSecond).toBeNull()
+    })
+
+    it('uses full geometry length when no stations', () => {
+      const feature = makeLiftFeature({ stations: [] })
+      const result = getLiftElevationData(feature)!
+      expect(result.speedInMetersPerSecond).toBeGreaterThan(0)
+      // Speed should be inclinedLength / duration from geometry
+      const expectedSpeed = result.inclinedLengthInMeters / 600
+      expect(result.speedInMetersPerSecond).toBeCloseTo(expectedSpeed)
+    })
+
+    it('uses full geometry length when only one terminal station is present', () => {
+      const noStations = makeLiftFeature({ stations: [] })
+      const oneStation = makeLiftFeature({
+        stations: [makeStation(LiftStationPosition.Bottom, [8.0, 46.0, 1000])],
+      })
+      const resultNoStations = getLiftElevationData(noStations)!
+      const resultOneStation = getLiftElevationData(oneStation)!
+      expect(resultOneStation.speedInMetersPerSecond).toBeCloseTo(
+        resultNoStations.speedInMetersPerSecond!,
+      )
+    })
+
+    it('uses station-based distance when top and bottom stations have elevation', () => {
+      // Geometry extends beyond the stations (extra approach at each end)
+      const feature = makeLiftFeature({
+        coordinates: [
+          [8.0, 46.0, 900],    // approach before bottom station
+          [8.005, 46.01, 1000], // bottom station location
+          [8.015, 46.04, 1500], // top station location
+          [8.02, 46.05, 1600],  // approach after top station
+        ],
+        duration: 600,
+        stations: [
+          makeStation(LiftStationPosition.Bottom, [8.005, 46.01, 1000]),
+          makeStation(LiftStationPosition.Top, [8.015, 46.04, 1500]),
+        ],
+      })
+
+      const resultWithStations = getLiftElevationData(feature)!
+
+      // Without stations, use full geometry (which is longer)
+      const featureNoStations = makeLiftFeature({
+        coordinates: [
+          [8.0, 46.0, 900],
+          [8.005, 46.01, 1000],
+          [8.015, 46.04, 1500],
+          [8.02, 46.05, 1600],
+        ],
+        duration: 600,
+        stations: [],
+      })
+      const resultNoStations = getLiftElevationData(featureNoStations)!
+
+      // Station-based distance is shorter → lower speed
+      expect(resultWithStations.speedInMetersPerSecond).toBeLessThan(
+        resultNoStations.speedInMetersPerSecond!,
+      )
+      expect(resultWithStations.verticalSpeedInMetersPerSecond).toBeLessThan(
+        resultNoStations.verticalSpeedInMetersPerSecond!,
+      )
+    })
+
+    it('falls back to geometry when stations have no elevation', () => {
+      const featureWithStations = makeLiftFeature({
+        stations: [
+          makeStation(LiftStationPosition.Bottom, [8.0, 46.0]),  // no Z
+          makeStation(LiftStationPosition.Top, [8.01, 46.05]),    // no Z
+        ],
+      })
+      const featureNoStations = makeLiftFeature({ stations: [] })
+
+      const resultWithStations = getLiftElevationData(featureWithStations)!
+      const resultNoStations = getLiftElevationData(featureNoStations)!
+
+      expect(resultWithStations.speedInMetersPerSecond).toBeCloseTo(
+        resultNoStations.speedInMetersPerSecond!,
+      )
+    })
+  })
+
   describe('getFormattedLiftType', () => {
     it('should format lift types correctly', () => {
       expect(getFormattedLiftType(LiftType.ChairLift)).toBe('Chairlift');
@@ -21,4 +189,4 @@ describe('Lift', () => {
       expect(getLiftColor(Status.Construction)).toBe('hsl(0, 82%, 42%)');
     });
   });
-});
+});

package/src/Lift.ts

@@ -1,11 +1,13 @@
+import distance from '@turf/distance'
 import { ElevationData, getElevationData } from './ElevationProfile'
 import { FeatureType } from './FeatureType'
 import { Place } from './Place'
 import { SkiAreaSummaryFeature } from './SkiArea'
 import { Source } from './Source'
-import { LiftStationSpotFeature } from './Spot'
+import { LiftStationPosition, LiftStationSpotFeature } from './Spot'
 import { Status } from './Status'
 import { exhaustiveMatchingGuard } from './util/exhaustiveMatchingGuard'
+import { ViewportHint } from './ViewportHint'
 
 export type LiftFeature = GeoJSON.Feature<LiftGeometry, LiftProperties>
 
@@ -77,6 +79,7 @@ export type LiftProperties = {
   websites: string[]
   wikidataID: string | null
   places: Place[]
+  viewportHint: ViewportHint
 }
 
 export enum LiftType {
@@ -113,18 +116,59 @@ export function getLiftElevationData(
 
   const elevationData = getElevationData(geometry)
   const durationInSeconds = feature.properties.duration
+  const terminalDistances = getTerminalStationDistances(feature)
+  const inclinedLength =
+    terminalDistances?.inclinedLengthInMeters ??
+    elevationData.inclinedLengthInMeters
+  const verticalLength =
+    terminalDistances?.verticalInMeters ?? elevationData.verticalInMeters
 
   return {
     ...elevationData,
     speedInMetersPerSecond: durationInSeconds
-      ? elevationData.inclinedLengthInMeters / durationInSeconds
+      ? inclinedLength / durationInSeconds
       : null,
     verticalSpeedInMetersPerSecond: durationInSeconds
-      ? elevationData.verticalInMeters / durationInSeconds
+      ? verticalLength / durationInSeconds
       : null,
   }
 }
 
+function getTerminalStationDistances(
+  feature: LiftFeature,
+): { inclinedLengthInMeters: number; verticalInMeters: number } | null {
+  const stations = feature.properties.stations
+  const topStation = stations.find(
+    (s) => s.properties.position === LiftStationPosition.Top,
+  )
+  const bottomStation = stations.find(
+    (s) => s.properties.position === LiftStationPosition.Bottom,
+  )
+
+  if (!topStation || !bottomStation) {
+    return null
+  }
+
+  const topCoords = topStation.geometry.coordinates
+  const bottomCoords = bottomStation.geometry.coordinates
+
+  if (topCoords.length < 3 || bottomCoords.length < 3) {
+    return null
+  }
+
+  const horizontalDistanceInMeters = distance(
+    topStation.geometry,
+    bottomStation.geometry,
+    { units: 'meters' },
+  )
+  const verticalInMeters = Math.abs(topCoords[2] - bottomCoords[2])
+  const inclinedLengthInMeters = Math.sqrt(
+    Math.pow(horizontalDistanceInMeters, 2) + Math.pow(verticalInMeters, 2),
+  )
+
+  return { inclinedLengthInMeters, verticalInMeters }
+}
+
 export function getFormattedLiftType(liftType: LiftType): string {
   switch (liftType) {
     case LiftType.CableCar:

package/src/Run.ts

@@ -13,6 +13,7 @@ import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
 import { exhaustiveMatchingGuard } from './util/exhaustiveMatchingGuard'
+import { ViewportHint } from './ViewportHint'
 
 export type RunGeometry = GeoJSON.LineString | GeoJSON.Polygon
 
@@ -88,6 +89,7 @@ export type RunProperties = {
   wikidataID: string | null
   places: Place[]
   snowCoverHistory?: SnowCoverHistory
+  viewportHint: ViewportHint
 }
 
 export enum RunUse {

package/src/SkiArea.ts

@@ -6,6 +6,7 @@ import { RunDifficultyConvention } from './RunDifficultyConvention'
 import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
+import { ViewportHint } from './ViewportHint'
 
 /**
  * A ski area feature is derived from several sources:
@@ -58,6 +59,7 @@ export type SkiAreaProperties = SkiAreaSummaryProperties & {
   websites: string[]
   wikidataID: string | null
   places: Place[]
+  viewportHint: ViewportHint
 }
 
 export type SkiAreaSummaryProperties = {

package/src/Spot.ts

@@ -3,6 +3,7 @@ import { FeatureType } from './FeatureType'
 import { Place } from './Place'
 import { SkiAreaSummaryFeature } from './SkiArea'
 import { Source } from './Source'
+import { ViewportHint } from './ViewportHint'
 
 /**
  * A GeoJSON feature representing a spot (point of interest) in or around a ski area.
@@ -43,6 +44,7 @@ export type SpotBaseProperties = {
   skiAreas: SkiAreaSummaryFeature[]
   sources: Source[]
   places: Place[]
+  viewportHint: ViewportHint
 }
 
 /**

package/src/ViewportHint.ts

@@ -0,0 +1,205 @@
+import * as GeoJSON from 'geojson'
+import distance from '@turf/distance'
+
+/**
+ * Pre-computed viewport positioning data stored on every feature's properties.
+ * Camera space: Y axis points uphill (along bearing), X axis points screen-right.
+ * Metric values are in that rotated frame with elevation-adjusted Y positions
+ * (at 45° pitch, Δe metres above mean elevation shifts Y by Δe metres).
+ */
+export type ViewportHint = {
+  /** Geographic centre of the rotated bounding box as [lng, lat]. */
+  center: [number, number]
+
+  /**
+   * Uphill bearing in degrees clockwise from north. null when elevation variation is
+   * insufficient to determine orientation — client should use top-down view (pitch 0, bearing 0).
+   */
+  bearing: number | null
+
+  /** Bounding box width along the camera X axis, in metres. */
+  rotatedWidthMeters: number
+
+  /** Bounding box height along the camera Y axis, in metres (elevation-adjusted). */
+  rotatedHeightMeters: number
+
+  /**
+   * Most-downhill edge of the elevation-adjusted bounding box in camera-Y metres, relative
+   * to mean feature elevation. Used to compute the perspective centre shift at 45° pitch:
+   * look-at point = minCameraY + nearFraction * rotatedHeightMeters, where
+   * nearFraction = nearGround / (nearGround + farGround) from camera pitch and vFOV.
+   */
+  minCameraY: number
+}
+
+/**
+ * Computes a ViewportHint from one or more GeoJSON geometries.
+ * All geometry types are accepted; elevation is read from the Z coordinate (defaults to 0).
+ * Throws if no coordinates are found.
+ */
+export function computeViewportHint(
+  geometries: GeoJSON.Geometry[],
+): ViewportHint {
+  // Collect all coordinates (for bbox + elevation stats) and consecutive segment pairs
+  // (for the downhill bearing calculation).
+  const allCoords: [number, number, number][] = []
+  const bearingSegments: [[number, number, number], [number, number, number]][] =
+    []
+
+  for (const geom of geometries) {
+    collectGeometry(geom, allCoords, bearingSegments)
+  }
+
+  if (allCoords.length === 0) throw new Error('computeViewportHint: no coordinates found in provided geometries')
+
+  let minLng = Infinity,
+    maxLng = -Infinity
+  let minLat = Infinity,
+    maxLat = -Infinity
+  for (const [lng, lat] of allCoords) {
+    if (lng < minLng) minLng = lng
+    if (lng > maxLng) maxLng = lng
+    if (lat < minLat) minLat = lat
+    if (lat > maxLat) maxLat = lat
+  }
+
+  const centerLng = (minLng + maxLng) / 2
+  const centerLat = (minLat + maxLat) / 2
+
+  // Weight each segment's downhill direction by length to find dominant bearing.
+  let sumSin = 0,
+    sumCos = 0
+  for (const [[lng0, lat0, elev0], [lng1, lat1, elev1]] of bearingSegments) {
+    if (elev0 === elev1) continue
+    const [fromLng, fromLat, toLng, toLat] =
+      elev0 > elev1
+        ? [lng0, lat0, lng1, lat1]
+        : [lng1, lat1, lng0, lat0]
+    const bear = greatCircleBearing(fromLat, fromLng, toLat, toLng)
+    const len = distance([lng0, lat0], [lng1, lat1], { units: 'meters' })
+    const bearingRad = (bear * Math.PI) / 180
+    sumSin += Math.sin(bearingRad) * len
+    sumCos += Math.cos(bearingRad) * len
+  }
+
+  // Uphill bearing = downhill + 180°; null if no elevation variation found.
+  let mapBearing: number | null = null
+  if (sumSin !== 0 || sumCos !== 0) {
+    const dominantDownhill = (Math.atan2(sumSin, sumCos) * 180) / Math.PI
+    const normalizedDownhill = ((dominantDownhill % 360) + 360) % 360
+    mapBearing = (normalizedDownhill + 180) % 360
+  }
+
+  const metersPerDeg = 111320
+  const cosLat = Math.cos(centerLat * (Math.PI / 180))
+  const bearingRad = ((mapBearing ?? 0) * Math.PI) / 180
+
+  let elevationSum = 0
+  for (const [, , elev] of allCoords) elevationSum += elev
+  const meanElevation = elevationSum / allCoords.length
+
+  let minCameraX = Infinity,
+    maxCameraX = -Infinity
+  let minCameraY = Infinity,
+    maxCameraY = -Infinity
+
+  for (const [lng, lat, elev] of allCoords) {
+    const dx = (lng - centerLng) * cosLat * metersPerDeg
+    const dy = (lat - centerLat) * metersPerDeg
+    const cx = dx * Math.cos(bearingRad) - dy * Math.sin(bearingRad)
+    const cy = dx * Math.sin(bearingRad) + dy * Math.cos(bearingRad)
+    // At 45° pitch, elevation above mean shifts apparent Y by the same amount (tan 45° = 1).
+    const cyEffective = cy + (elev - meanElevation)
+    if (cx < minCameraX) minCameraX = cx
+    if (cx > maxCameraX) maxCameraX = cx
+    if (cyEffective < minCameraY) minCameraY = cyEffective
+    if (cyEffective > maxCameraY) maxCameraY = cyEffective
+  }
+
+  return {
+    center: [centerLng, centerLat],
+    bearing: mapBearing,
+    rotatedWidthMeters: maxCameraX - minCameraX,
+    rotatedHeightMeters: maxCameraY - minCameraY,
+    minCameraY,
+  }
+}
+
+/** Recursively extracts coordinates and segment pairs from a geometry. */
+function collectGeometry(
+  geom: GeoJSON.Geometry,
+  allCoords: [number, number, number][],
+  bearingSegments: [[number, number, number], [number, number, number]][],
+): void {
+  switch (geom.type) {
+    case 'Point': {
+      const [lng, lat, elev = 0] = geom.coordinates
+      allCoords.push([lng, lat, elev])
+      break
+    }
+    case 'MultiPoint': {
+      for (const pos of geom.coordinates) {
+        const [lng, lat, elev = 0] = pos
+        allCoords.push([lng, lat, elev])
+      }
+      break
+    }
+    case 'LineString':
+      collectPositions(geom.coordinates, allCoords, bearingSegments)
+      break
+    case 'MultiLineString':
+      for (const line of geom.coordinates) {
+        collectPositions(line, allCoords, bearingSegments)
+      }
+      break
+    case 'Polygon':
+      for (const ring of geom.coordinates) {
+        collectPositions(ring, allCoords, bearingSegments)
+      }
+      break
+    case 'MultiPolygon':
+      for (const polygon of geom.coordinates) {
+        for (const ring of polygon) {
+          collectPositions(ring, allCoords, bearingSegments)
+        }
+      }
+      break
+    case 'GeometryCollection':
+      for (const g of geom.geometries) {
+        collectGeometry(g, allCoords, bearingSegments)
+      }
+      break
+  }
+}
+
+/** Adds positions to allCoords and consecutive pairs to bearingSegments. Z defaults to 0. */
+function collectPositions(
+  positions: GeoJSON.Position[],
+  allCoords: [number, number, number][],
+  bearingSegments: [[number, number, number], [number, number, number]][],
+): void {
+  const elevated: [number, number, number][] = positions.map(
+    ([lng, lat, elev = 0]) => [lng, lat, elev],
+  )
+  for (const coord of elevated) allCoords.push(coord)
+  for (let i = 0; i < elevated.length - 1; i++) {
+    bearingSegments.push([elevated[i], elevated[i + 1]])
+  }
+}
+
+/** Great-circle bearing from (lat1, lng1) to (lat2, lng2), in degrees 0–360. */
+function greatCircleBearing(
+  lat1: number,
+  lng1: number,
+  lat2: number,
+  lng2: number,
+): number {
+  const toRad = (d: number) => (d * Math.PI) / 180
+  const φ1 = toRad(lat1)
+  const φ2 = toRad(lat2)
+  const Δλ = toRad(lng2 - lng1)
+  const y = Math.sin(Δλ) * Math.cos(φ2)
+  const x =
+    Math.cos(φ1) * Math.sin(φ2) - Math.sin(φ1) * Math.cos(φ2) * Math.cos(Δλ)
+  return ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360
+}

package/src/index.ts

@@ -11,3 +11,4 @@ export * from './SnowCoverHistory'
 export * from './Source'
 export * from './Spot'
 export * from './Status'
+export * from './ViewportHint'