Pano Mapper
Turn a 360° video and a GPX track into geolocated 360° photos.
On this page
Pano Mapper generates geolocated 360° panorama images from a 360° video and a GPX track. Its output can be sent to PanoCool Street View Publisher for Google Maps publishing or used to create a project in PanoCool Virtual Tour Studio.
Links
- Product landing page: https://pano.cool/products/pano-mapper
- Pano Mapper tool: https://pano.cool/pano-mapper
- Video: Create Automated 360 Walkthroughs with Insta360 Video & GPS Data
Overview
Pano Mapper takes a 360° MP4 video and its corresponding GPX file, then automatically extracts evenly spaced 360° JPEG images along the recorded route. The extracted images include GPS coordinates, heading, and navigation connections, ready to publish to Google Street View or use in a virtual tour.
How to use Pano Mapper
- Upload files: Drop a 360° video file in MP4 format and a GPX file on the page, or pick them with Select 360° video and Select GPX file. The tool validates the video aspect ratio; 2:1 equirectangular video is expected.
- Configure floors: Choose a single-floor or multi-floor workflow (Single floor or Multiple floors). For a multi-floor recording, such as different levels of a building, use the timeline handles to define the time range for each floor.
- Generate images: Set the spacing distance from 2 to 100 meters; the default is 5 meters. Pano Mapper shows how many images that makes. Select
Generate imagesto extract 360° JPEG images at evenly spaced points along the route. A progress bar shows extraction status. - Review and edit: Preview generated nodes on the map, where each floor has a distinct color, and in the 360° viewer. Add or remove individual nodes and preview the complete walk-through tour.
- Export: Send the images to Street View Publisher or create a Virtual Tour Studio project.
Key features
- Map and video preview: A two-column interface shows an interactive Google Map with the GPX route as a green polyline and a synchronized video player. A red dot on the map tracks the current video position in real time.
- Multi-floor support: Define multiple floors and their time ranges with a visual timeline and draggable handles. Each floor receives a unique map color.
- Configurable spacing: Set the distance between generated images from 2 to 100 meters. Pano Mapper shows how many images it will generate before you start. A spot the route passes twice, or where you stood still, gets one image.
- Auto-generated connections: Sequential connections are created within each floor. Each floor’s first node is connected to the nearest node of the floor before it when they are within 20 meters of each other.
- Manual node editing: Add a node at the current video position or remove an existing node. Connections are rewired automatically when nodes are added or removed.
- GPS-video synchronization offset: Adjust an offset in seconds to align the GPX track with the video when they are not perfectly synchronized.
- 360° preview: Select any generated node to inspect it in a 360° viewer. Open a complete walk-through preview with Street View-style navigation.
- Export to Street View Publisher: Send every generated image, together with its GPS data, connections, and floor level, to Street View Publisher for publishing to Google Maps.
- Export to Virtual Tour Studio: Create a virtual tour project with all generated images as scenes. The Street View Arrows add-on is configured automatically with GPS positions, connections, and floor levels, making the walk-through ready for immediate navigation. This export requires a paid plan.
Align the GPX track with the video
When the camera and the GPS logger started recording at different times, the red dot on the map runs ahead of or behind the video.
- Play or scrub the video to a moment you can find on the map, such as a corner or a crossing.
- Under the 360° Video Preview, change Time offset (in seconds) until the red dot sits where the camera was at that moment. A positive value moves the dot further along the route; a negative value moves it back.
- Select Generate images, or add single images with Add node here. Both use the offset, so each image shows the moment the red dot reaches its spot. Generate images places images at evenly spaced points along each floor’s stretch of the route; where you stopped, the image shows the moment you got there. Add node here places the image exactly where the red dot is.
If you change the offset after generating, select Generate images again.
When the offset puts the start or the end of the route outside the video, that stretch gets no images. It shows grey on the map, and Pano Mapper tells you how much of the route has no images.
Input requirements
- Video: A 360° equirectangular MP4 video. A 2:1 aspect ratio is recommended.
- GPX file: A standard GPX file with
<trkpt>track points containing latitude and longitude. Timestamps and elevation are optional but improve accuracy.
Plans and login requirements
- Generating images and exporting them to Street View Publisher is free and does not require login.
- Exporting directly to Virtual Tour Studio requires the
CoolorSuper Coolplan.