3D Tilesets are perfect for displaying large terrain meshes or detailed photogrammetry outputs โ like full site scans or landscape models. Swyvl supports 3D Tiles 1.0 and 1.1, including data exported from RealityCapture, iTwin and other photogrammetry tools.
Step 1: Prepare Your 3D Tileset
Before uploading, your tileset must be structured correctly:
The files should be packaged into a .zip folder.
Your zipped folder must contain:
A
tileset.jsonfile at the root level
โSome programs such iTwin will rename the json file to something different, that is fine, as long as the .json is at the root, or top level of that folderOne or more tile files;
For photogrammetry .b3dm (batched 3d model) files
For point clouds .pnts
๐ Need help exporting 3D Tiles from RealityCapture?
โRead this guide โ
Step 2: Upload Your 3D Tileset to Swyvl
In your Project, go to the Toolbar and select 3D Data > 3D Tileset.
Choose whether to:
Upload new: Select your
.zipfileChoose existing: Use a tileset already in your Resources
Swyvl will process the file and place the 3D Tileset in your project.
๐ Placement will center the tileset based on its internal geolocation.
Step 3: Adjust Your Tileset (Optional)
After uploading, click the settings icon next to your 3D Tileset in the Project Data Sidebar to open the Properties Panel.
In the Placement Tab, you can:
Adjust the height
โ(Useful if your tileset appears floating)
In the Styling Tab, you can:
Enable a Color Overlay and its opacity
In the Manage Tab, you can:
Set the Level of Detail:
Lower values = higher visual detail but more data usage
Higher values = lower detail but better performance
Default = 16
This gives you control over visual quality vs performance depending on your viewerโs needs.
Youโre Done
Your 3D Tileset is now part of your project. You can reposition, style, and manage it just like any other data item โ and it can be toggled on/off using the viewer controls.
Troubleshooting
3D Tileset appears cut off or partially hidden?
This can sometimes happen if the tileset is being clipped by terrain layers (especially when using Google 3D Tiles as your basemap).
To fix this:
Open the Sidebar in the Builder.
Go to the Project Settings tab.
Scroll to Map Settings.
Switch off the toggle for โDepth test against terrain.โ
This will stop the map from visually cutting through the tileset, ensuring the full model is displayed.
