Map Navigation
Benchmrk's map is powered by a modern mapping engine, providing a smooth, GPU-accelerated experience for browsing survey marks across Australia. This page covers the core navigation controls and interaction patterns.
Basic controls
Zoom
| Action | Mouse | Trackpad | Touch |
|---|---|---|---|
| Zoom in | Scroll wheel up | Pinch out | Pinch out |
| Zoom out | Scroll wheel down | Pinch in | Pinch in |
| Zoom to area | Shift + drag a rectangle | — | — |
| Zoom in one level | Double-click | Double-tap | Double-tap |
You can also use the + and − zoom buttons in the bottom-right corner of the map.
Pan
| Action | Mouse | Trackpad | Touch |
|---|---|---|---|
| Pan | Click and drag | Two-finger drag | One-finger drag |
Rotate and tilt
| Action | Mouse | Trackpad |
|---|---|---|
| Rotate | Right-click and drag | — |
| Tilt (pitch) | Ctrl + drag | — |
If you've rotated or tilted the map and want to reset, click the compass icon in the map controls to return to north-up, flat view.
Click-to-select
Clicking on a survey mark on the map selects it:
- Click a mark — The mark is highlighted with a selection indicator.
- Point details panel opens — The sidebar shows the mark's full metadata.
- Map centres on the mark — A subtle pan animation centres the selected mark in view.
Clicking empty space
Clicking on an area of the map with no marks:
- Deselects the currently selected mark (if any).
- Closes the point details panel.
- In AI Assist pin-drop mode, clicking empty space places or moves the analysis pin.
Zoom thresholds
Survey marks are only visible at certain zoom levels. This is a deliberate design choice — at low zoom levels (zoomed out to see an entire state), rendering thousands of marks would be overwhelming and slow.
- Zoomed out (low zoom) — No marks visible. You see the base map only.
- Medium zoom — Mark clusters or density indicators may appear.
- Zoomed in (high zoom) — Individual marks are visible with their symbology icons.
If you don't see any marks on the map, try zooming in. The marks appear once you reach the visibility threshold for the current jurisdiction.
Fly-to animations
Several actions trigger a fly-to animation that smoothly pans and zooms the map to a target location:
- Selecting a search result — The map flies to the mark's coordinates.
- Clicking a Ledger entry — The map flies to the saved mark's location.
- Coordinate search — The map flies to the entered coordinates.
- Tutorial action links —
benchmrk-action://fly-tolinks trigger a fly-to from within the docs.
Fly-to animations use a smooth fly-to animation, which provides a smooth, camera-like transition.
Map interaction patterns
Benchmrk uses standard patterns for map interaction:
- Vector tiles — Map data is loaded as vector tiles for fast rendering and smooth zooming.
- Layers and sources — Survey marks are rendered as map layers with jurisdiction-specific styling.
- Event handling — Click, hover, and move events are handled through the map's event system.
- WebGL rendering — The map uses WebGL for hardware-accelerated rendering, which requires a browser with WebGL support.
Benchmrk requires a browser with WebGL support. If the map doesn't render, check that WebGL is enabled in your browser settings. See Browser Compatibility for details.
Map and DocsPanel
When the DocsPanel is open, the map resizes to share the screen. The map remains fully interactive — you can zoom, pan, and click marks while reading documentation side by side.