Skip to content

πŸš€πŸš€ New Feature: Rotate Map

Choose a tag to compare

@cataseven cataseven released this 08 Mar 09:04
89c7241

πŸ”„ Vector Map & Free Rotation

rotate

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_mode and the 40+ built-in JSON themes are not available in vector mode (Google API limitation β€” the styles array is raster-only)
  • color_scheme takes 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_ratio to control card height
  • Sections dashboards: use aspect_ratio and use grid_options: columns: full / rows: auto to 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