Skip to main content
Legacy data modeling
Mapping 3D nodes to asset-centric assets is deprecated. Link 3D objects to CogniteAsset with the 3D contextualization APIs. These endpoints are in public preview. The Python SDK does not include these endpoints yet, so call them over HTTP. 3D model upload stays available. You can upgrade 3D models and mappings with the migration plugin.See Data modeling status for CDF projects for how 3D behavior differs between DATA_MODELING_ONLY and HYBRID projects.
The 3D asset mapping API lets you create and manage links between 3D model nodes and CDF assets. This connection enables you to navigate from a 3D visualization to the corresponding asset data (time series, events, files) and vice versa.

​
Why map nodes to assets?

Mapping 3D nodes to assets lets you:
  • Navigate from 3D to data — Click a node in a 3D view to see its associated time series, events, or files
  • Navigate from data to 3D — Start from an asset and locate its representation in one or more 3D models
  • Enrich visualizations — Display live asset data alongside 3D geometry

​
Key operations

You can create mappings, update them, and query them in several ways:
  • Filter by bounding box — Find nodes within a spatial region
  • Find mappings for an asset — Retrieve all 3D mappings for a given asset across models
Asset mappings are per-model and per-revision. When you update a revision, you may need to recreate or verify mappings.
Last modified on April 23, 2026