Saved Views API
This API provides functionality to store, share, organize, and retrieve saved views.
Saved views enable applications to maintain display information on how to visualize an iTwin. The information stored in a saved view depends on its type. A saved view relates to an iTwin.js view definition, which comes in three different flavors:
- 3D View: these views include camera position, camera angle, camera extents, viewed categories and viewed models.
- Drawing Views: these views include the origin of the view, angles, the model being viewed and the viewed categories.
- Sheet Views: these views include all the information from drawing views, and includes optional width, height, scale and sheet related properties, like sheet attachments.
Saved views can be shared, have thumbnails, be organized into groups, and have a list of user-defined tags.
Saved views are always related to a specific iTwin or a specific Project.
The API has operations to upload and get images related to a specific saved view. These images are typically used as thumbnails to show how the saved view looks when visualizing it. You can request the images in two sizes:
The API allows for the creation of Groups that can be used to organize collections of saved views. Groups can be shared if desired. The user can then query saved views that are associated with a specific group by using its id.
The API allows for marking saved views with user-created tags. Tags are simple strings that users can use for organization purposes.