Swyvl allows you to combine various types of spatial data into a single project. You can upload all these assets using the Top Toolbar in the Builder.
You can add content to your project using the Top Toolbar in the Builder. The toolbar is organized into categories based on the type of data you are creating or importing.
Toolbar Menu | Options | Supported File Types/Input |
Draw Tools | Point, Line, Polygon, Embed | Creation Tools (no file upload required). Use these to draw shapes or add information points. |
Photo Tools | Photo, 360 Photo | .jpg |
Site & Floor Plans | Site Plan, Floor Plan | .jpg |
Linework | GeoJSON | .geojson |
Imagery | TMS Tiles, XYZ Tiles | .zip (containing tile directory structure) |
3D Data | 3D Model | .glb |
| 3D Tileset | .zip |
1. Draw Tools
These are creation tools used to annotate the map directly. You do not upload files for these; you draw them on the canvas.
Point, Line, Polygon: Mark locations, draw paths, or outline areas.
Embed: Add a marker that displays a website or video via a URL.
2. Photo Tools
Use these to add visual context from the ground or air.
Photo: Standard 2D images (e.g., inspection photos).
360 Photo: Immersive panoramas (must be 2:1 aspect ratio).
Note: For Path View tours, you must also upload a .gpx file to automatically position your photos.
3. Site & Floor Plans
Import 2D drawings to overlay on the map.
Site Plan: Best for large outdoor areas. Covers the map globally.
Floor Plan: Best for indoor building levels. Can be stacked vertically.
Format Note: PDF files are not supported. You must convert them to JPG or PNG before uploading.
[Link to Article: Managing Site and Floor Plans]
4. Linework
Import vector data to display technical boundaries or utility lines.
GeoJSON: The standard format for web-based vector data.
Requirement: Must use EPSG:4326 coordinate system.
[Link to Article: Importing Linework (GeoJSON)]
5. Imagery
Upload pre-processed map tiles to replace or overlay the Basemap.
TMS / XYZ Tiles: Upload a .zip file containing your tiles (folder structure or flat files).
Note: Swyvl hosts these files for you; you do not need an external server.
[Link to Article: Uploading Imagery (TMS and XYZ)]
6. 3D Data
Import 3D content for spatial context.
3D Model: Individual objects or buildings. Supports
.glband.gltf.3D Tileset: Large-scale streaming data (e.g., RealityCapture exports). Must be uploaded as a .zip containing a
tileset.jsonfile at the root.