ππ New Feature: Rotate Map
π Vector Map & Free Rotation
The card now supports Google Maps' WebGL-based vector rendering mode, unlocking true 360Β° rotation and tilt on any map type β roadmap, satellite, hybrid, and terrain β with no Map ID or Google Cloud Console setup required.
New config parameters
| Key | Type | Default | Description |
|---|---|---|---|
rendering_type |
string | raster |
raster (default) or vector. Vector mode enables free rotation and tilt. |
color_scheme |
string | light |
Vector mode only. light, dark, or follow_system. Replaces theme_mode in vector mode. |
Rotate & Tilt Grid Control (cameraControl in vector mode)
In vector mode, enabling cameraControl: true replaces the native (non-functional) pan buttons with a custom rotate & tilt grid:
[ β Decrease Tilt ]
[ β Rotate ] [ β³ Reset ] [ β Rotate ]
[ β Increase Tilt ]
- Rotate step: 15Β°
- Tilt step: 10Β° (range 0Β°β67.5Β°)
- β³ resets both heading and tilt to 0
Mobile: 2-Finger Gestures (vector mode only)
- 2-finger drag up/down β tilt the map (perspective control)
- 2-finger rotate β rotate the map heading freely
These gestures are native to Google Maps vector rendering and require no additional configuration β they activate automatically when rendering_type: vector is set.
Right-click + Drag to Tilt (vector mode only)
- Hold right mouse button and drag down β increase tilt (more perspective)
- Hold right mouse button and drag up β decrease tilt (flatter)
- Release without dragging β right-click popup opens as normal
UI Editor
- Rendering Mode dropdown added to Main Settings (Raster / Vector)
- When Vector is selected, the Theme dropdown is replaced by a Color Scheme selector (Light / Dark / Follow System)
Notes
theme_modeand the 40+ built-in JSON themes are not available in vector mode (Google API limitation β thestylesarray is raster-only)color_schemetakes effect at map initialization only; changing it via the editor triggers an automatic reload- Raster mode behavior is completely unchanged
π Dashboard Layout Tips (README)
Added a new Dashboard Layout Tips section to the README explaining:
- Masonry / Panel dashboards: use
aspect_ratioto control card height - Sections dashboards: use
aspect_ratioand usegrid_options: columns: full / rows: autoto adjust the size properly
β οΈ Rotate & Tilt Limitations (README)
Expanded the rotateControl documentation to clearly explain:
- When the native rotate control works (satellite/hybrid, zoom β₯ 15, supported cities only)
- Why it doesn't work on roadmap / terrain (raster tile rendering limitation)
- Reference to the new vector mode for unrestricted rotation
