Getting Started
Site Detail & Map
The site detail page is where all the real work happens in SiteView. It combines a full 3D CesiumJS map with a floating panel that gives you access to your site's surveys, design layers, measurements, and timeline — all in one view.
![[Screenshot: SiteView site detail page showing a 3D map with satellite imagery and a floating panel on the left side displaying the Overview tab with site stats]](/images/placeholder.png)
Layout
The site detail page is designed around the principle that the map should always be visible. Everything else — site information, surveys, layers, measurements — is accessed through a floating panel that overlays the map without replacing it.
Desktop Layout
On desktop and laptop screens, the floating panel sits on the left side of the screen. It is 380 pixels wide and extends from below the header to the bottom of the viewport. The 3D map fills the rest of the screen behind and around the panel.
The panel can be collapsed by clicking the toggle button on its right edge. When collapsed, the map takes over the full screen, giving you maximum space for spatial analysis. Click the toggle again to bring the panel back.

💡 Tip
Collapse the panel when you need more map space for measurement tools or when you are zooming around the site. The map tools remain accessible even when the panel is hidden.
Mobile Layout
On phones and small tablets, the floating panel is replaced by a bottom sheet — a draggable panel that slides up from the bottom of the screen. The bottom sheet has three states:
| State | Behaviour |
|---|---|
| Peek | The sheet shows just the site name and tab bar at the bottom of the screen. The map is fully visible above |
| Half | The sheet covers roughly half the screen, showing the tab content with the map visible above |
| Full | The sheet covers most of the screen, useful for reading longer content like measurement lists or timeline entries |
Drag the handle at the top of the sheet to move between states. The sheet remembers your preferred state within the session.

ℹ️ Did you know?
The bottom sheet pattern is widely used in mapping applications. If you have used Google Maps or Apple Maps on your phone, the interaction will feel familiar — drag up for more detail, drag down to see more map.
The Compact Header
At the top of the floating panel (or bottom sheet), a compact header displays:
- Site name — the full name of the site
- Status badge — a colour-coded badge showing the current status (active, on hold, completed, archived)
- Edit button — opens the site edit form to update name, description, tags, and other details
- Action menu — additional actions such as deleting the site or managing settings
Quick Status Change
Click the status badge in the header to open a dropdown that lets you change the site's status immediately. Select the new status and it updates instantly — the pin colour on the globe changes to match, and the status badge refreshes in the header.
![[Screenshot: Site detail header showing the site name, green Active status badge with dropdown open showing On Hold, Completed, and Archived options, and Edit and Action buttons]](/images/placeholder.png)
The Five Tabs
Below the header, the panel content is organised into five tabs. Each tab provides a different view of your site data:
Overview Tab
The Overview tab is your site dashboard. It shows:
- Site statistics — counts of surveys, measurements, and design surfaces associated with this site
- Site details — description, tags, linked project, creation date
- Quick actions — shortcuts to common tasks like creating a survey, uploading a design file, or starting a measurement
This is the default tab when you first open a site. It gives you a quick summary of what exists on the site and what you can do next.
![[Screenshot: Overview tab showing three stat cards (Surveys: 3, Measurements: 12, Design Surfaces: 2), site description text, and quick action buttons]](/images/placeholder.png)
Surveys Tab
The Surveys tab lists all drone surveys and imported data associated with this site. From here you can:
- Create a new survey
- Upload drone imagery for processing
- Import pre-processed data (orthophotos, DEMs, point clouds) from Pix4D, DroneDeploy, or Metashape
- View processing status for active uploads
- Toggle survey layers on and off on the map
See Creating Surveys and Importing Processed Data for detailed guides.
Layers Tab
The Layers tab manages all visual overlays on the 3D map. This includes:
- Survey layers — orthophotos and elevation models from your processed surveys
- Design surfaces — DXF and KML/KMZ files you have uploaded
- Alignment visualisations — road and corridor alignments with chainage markers
Each layer has a visibility toggle, opacity slider, and options for styling. The Layers tab is your control centre for what appears on the map.
See Layer Management for a full guide.
Measurements Tab
The Measurements tab lists all measurements that have been taken on this site. Each measurement shows its type, value, and the date it was recorded. You can:
- View measurement details by clicking an entry
- Highlight a measurement on the map
- Delete measurements you no longer need
- Export measurements to CSV or PDF
Measurements are created using the measurement tools available on the map toolbar, not from within this tab. The tab provides the register and management interface.
Timeline Tab
The Timeline tab shows a chronological record of activity on the site — surveys uploaded, measurements taken, design files added, and status changes. It functions as an audit trail, helping you understand what has happened on the site and when.

💡 Tip
The Timeline tab is especially useful when multiple team members work on the same site. You can see who uploaded a survey, when a measurement was taken, and track the progression of work over time.
URL Persistence
SiteView preserves your selected tab in the URL. When you switch to the Measurements tab, for example, the URL updates to include that tab selection. This means:
- Refreshing the page returns you to the same tab
- Sharing a URL with a colleague sends them to the exact tab you were viewing
- Browser back/forward navigation moves between tabs naturally
This is a small detail that makes daily use smoother. If a colleague asks you about a specific measurement, you can share the URL and they will land directly on the Measurements tab.

ℹ️ Did you know?
URL persistence works for all five tabs. The URL format follows the pattern /sites/[id]?tab=measurements. If no tab is specified, the Overview tab is shown by default.
Working with the Map
The 3D map on the site detail page behaves the same as the globe view — scroll to zoom, click-drag to pan, right-drag to tilt. The key difference is that the site detail map is focused on a single site and includes:
- Measurement toolbar — access all ten measurement tools from the toolbar on the right side of the map
- Layer rendering — survey imagery, design surfaces, and alignments are rendered on the globe
- Design comparison tools — compare survey data against design surfaces directly on the map
- Base map selector — switch between Street, Outdoor, and Satellite base maps

⚠️ Watch out!
Some measurement tools require survey data or a design surface to be loaded. For example, the Volume tool needs an elevation model to calculate volumes, and the Grade Check tool needs a design surface for comparison. Make sure you have uploaded the relevant data before attempting these measurements.
Responsive Behaviour
The site detail page adapts to your screen size:
| Screen Size | Panel Style | Map Area |
|---|---|---|
| Desktop (1024px+) | 380px floating panel on the left, collapsible | Remaining screen width |
| Tablet (768px-1023px) | Narrower floating panel or bottom sheet | Remaining screen area |
| Phone (<768px) | Bottom sheet with peek/half/full drag states | Full width, above the sheet |
On all screen sizes, the map remains interactive behind the panel. You can still zoom, pan, and tilt the 3D view while the panel is open.
What's Next?
- Upload a drone survey — add imagery and elevation data to your site
- Overlay design files — upload DXF files to see your design on the globe
- Explore the measurement tools — learn about all ten measurement tools available on the map
- Site register — the list-based view for managing sites without the globe