Saltar al contenido principal

Locations

Use locations as filters on digital representations of physical areas such as platforms, plants, or factories. You can set up locations or a set of parent-child locations by specifying relevant filters across all your data.

We recommend that you set up one digital location for each physical location and evaluate if you need to split it into child locations. You can configure locations for any Cognite data model without altering how the data is modeled.

Users can filter their search results and select the resources to add to Canvas and Charts by a configured location.

Access

Use the locationfilters access capability to manage access to view location filters. Follow the instructions in Assign capabilities to provide access to the underlying data.

Configure locations

Use the Cognite Toolkit to configure locations. When you configure locations, you define which filters to apply. The location filter granularity in your CDF project depends on how you've modeled the data.

  • Data modeling: Specify which data models, data model versions, and data model spaces you want to use.

  • Asset-centric modeling: Specify data sets, asset sub-trees, or external ID prefixes for asset-centric resources, such as assets, events, files, time series, and sequences.

  • 3D content: To see 3D content for a location, you must set up scenes for the 3D content. The 3D scene displays in the 3D view when you filter on a location.

Note

If you're creating a hierarchy of parent-child locations, all the locations within the hierarchy must be part of the same asset sub-tree.