jubnl
c1b9d11173
Adds the complete TREK documentation wiki covering installation, trip planning, admin panel, MCP/AI integration, addons, and operations. Also fixes encrypt-at-rest gaps: mapbox_access_token, Synology credentials, per-user webhook/ntfy tokens, and photo passphrases are now rotated by migrate-encryption.ts and stored encrypted via settingsService.
3.0 KiB
Map Settings
The Map tab (Settings → Map) controls which map engine and tile source TREK uses in the Trip Planner and Journey maps. Changes take effect after clicking Save map settings.
Note: The Atlas view always uses Leaflet regardless of this setting.
Map provider
Choose the rendering engine:
| Provider | Description |
|---|---|
| Leaflet | Classic 2D renderer. Works with any raster tile URL. |
| Mapbox GL (Experimental) | Vector tiles with 3D buildings and terrain support. Requires a Mapbox access token. |
Leaflet — tile source
When Leaflet is selected, pick a preset or enter a custom tile URL.
Built-in presets:
| Name | URL |
|---|---|
| OpenStreetMap | https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png |
| OpenStreetMap DE | https://tile.openstreetmap.de/{z}/{x}/{y}.png |
| CartoDB Light | https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png |
| CartoDB Dark | https://{s}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}{r}.png |
| Stadia Smooth | https://tiles.stadiamaps.com/tiles/alidade_smooth/{z}/{x}/{y}{r}.png |
You can also type any XYZ tile URL directly into the text field.
Admin: The admin can set a default map tile URL for all new users via the User Defaults tab in the Admin Panel. See Admin-Panel-Overview.
Mapbox GL — access token and style
Enter your public token (pk.*) from mapbox.com → Access tokens.
If Mapbox GL is selected but no token is saved, the map area shows an empty state with a prompt to configure the token under Settings → Map → Mapbox GL.
Built-in style presets:
| Style | Tags |
|---|---|
| Mapbox Standard | 3D, Apple-like |
| Standard Satellite | 3D, Satellite |
| Streets | 3D, Classic |
| Outdoors | 3D, Terrain |
| Light | 3D, Minimal |
| Dark | 3D, Dark |
| Satellite | 3D, Satellite |
| Satellite Streets | 3D, Satellite |
| Navigation Day | 3D, Apple-like |
| Navigation Night | 3D, Dark |
You can also enter a custom mapbox://styles/USER/ID URL directly.
3D Buildings & Terrain
Enables pitch and building extrusions on all styles. Terrain elevation (DEM-based height) is additionally applied on satellite styles (Satellite and Satellite Streets). On non-satellite styles only building extrusions are added; terrain is intentionally omitted on those styles because the elevation data would cause route lines to visually drift away from the HTML place markers.
High Quality Mode (Experimental)
Enables antialiasing and globe projection for sharper edges. May impact performance on lower-end devices.
Default map center
Set the default latitude, longitude, and zoom level for the map. You can also click on the map preview to move the center pin.