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](https://docs.foursquare.com/analytics-products/docs/data-formats-gltf).

If a custom 3D model is not provided, Studio will create 3D ducks on the map as a sample model.

The 3D Layer displaying car models.

# Settings

The following sections reiterate the [3D models documentation](https://docs.foursquare.com/analytics-products/docs/layers-3d), 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.](https://docs.foursquare.com/analytics-products/docs/layer-3d#custom-3d-models) |
| 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](https://docs.foursquare.com/analytics-products/docs/data-formats-gltf) 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)](https://developer.mozilla.org/en-US/docs/Web/HTTP/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](https://docs.foursquare.com/developer/docs/studio-layer-reference#3d) specification.