For the complete documentation index, see llms.txt. This page is also available as Markdown.

360° Virtual Tour

Walk through a mapped space as a navigable 360° panoramic tour.

Overview

A 360° Virtual Tour turns a mapped space into a walk-through experience. Instead of looking at a mesh or a point cloud, you stand at a capture point, look around in full 360°, and step to the next point, the same way you would explore a street-level map.

Tours are generated automatically for 360 (Insta360) maps that have been processed for panoramic viewing. No extra capture step is required: if you have already mapped the space with a 360 camera, the tour comes from the same data.

A map's Map details response includes hasPano, which tells you whether that map has a tour available.

How it works

A tour is a graph of nodes. Each node is one 360° capture point and holds:

  • the panorama image for that spot,

  • its position and orientation in the map's coordinate frame,

  • links to its neighbouring nodes, with the distance to each in metres.

Because the nodes carry real positions, the tour is spatially aware. A viewer can jump to the node nearest a given location, or bias its choice toward whichever direction the user is facing, rather than only stepping along a fixed path.

View a tour in the Developer Portal

Open the map from the Maps list, then click Pano View in the Map Details toolbar:

Map Details toolbar with the Pano View button highlighted
Map Details toolbar. Open Pano View.

Inside the viewer, each ring on the floor is a neighbouring node you can click to move to. The minimap shows the full tour path and where you currently stand, and Go to lists nearby nodes with their distances.

360 tour viewer showing a panorama with navigation rings and a minimap
Drag to look around, scroll to zoom, and click a ring or any point on the floor to move.

Compare a space across map versions

When a map has been re-scanned as a Map Version, the tour can show the same viewpoint in each version, so you can compare a space before and after a change while standing in one spot.

Compare mode showing the same viewpoint across two map versions side by side
Compare mode: one viewpoint shown in two versions of the same space. Each match reports how far it sits from the anchor, in distance and angle.

One continuous tour across a MapSet

The maps in a MapSet can be presented as a single continuous tour. Where two maps meet, the tour bridges between them, so a visitor can walk from one map into the next without noticing a boundary.

360 tour spanning a MapSet, with the minimap showing multiple joined maps
A tour spanning a MapSet. The minimap shows the joined maps, and navigation flows from one map into the next.

Build your own viewer

Everything the Developer Portal viewer does is available over REST, so you can embed a tour in your own application: list the maps that have tours, load a complete tour in one call, or fetch just the neighbourhood around the user as they move.

See 360° Virtual Tour (Pano) API for the endpoints, the node shape, and request examples.

Last updated

Was this helpful?