3D Layer
3D layer displays 3D models on map by using latitude and longitude coordinates. Users may choose from our library of 3D models, or provide a custom model via a link to a glTF file.
If custom 3D model is not provided, Studio will create 3D ducks on map as a sample model.
Settings
The following sections reiterate the 3D models documentation, which details 3D model properties and settings.
The 3D model can be configured to best represent your use case.
Basic
Core settings for the 3D layer.
Setting | Description |
---|---|
Layer Type | Must be 3D to display the 3D layer. |
Dataset | The dataset to use for the 3D layer. |
Columns | Specify a latitude and longitude column. Optionally, include an altitude field. |
3D Model
Setting | Description |
---|---|
3D Model | An optional 3D model displayed for each moving object. Select from our library of 3D models or select Custom, then point to a link containing a .glb or .glTF file. |
Apply Color | Apply a color of your choice or apply the trail's color to the 3D model. |
Size Scale | Size is scaled by a factor of 2^x where x is the slider value. |
Angle X | Set the model's roll (rotation on the X-axis) via numerical input or with the slider. |
Angle Y | Set the model's pitch (rotation on the Y-axis) via numerical input or with the slider. |
Angle Z | Set the model's yaw (rotation on the Z-axis) via numerical input or with the slider. |
Custom 3D Models
To use your own 3D model, you can provide a link to a glTF file with either a .gltf (JSON/ASCII) or .glb (binary) extension.
If you need to render many models on the map, please consider the number of polygons of your model. A model that is too detailed (containing a high number of polygons) may result in significant slowdowns of your visualization.
Note: Cross Origin Resource Sharing (CORS) must be enabled on the remote server hosting the 3D model. This allows Studio to retrieve the 3D model for your visualization.
JSON Schema
For details on how to programmatically specify layer properties, refer to the Layer Configuration specification.
Updated 9 months ago