Building Scene Layer

Building scene layer structure

A building scene layer represents a 3D BIM model as a single layer composed of sublayers. A building scene layer is organized in discipline layers (groups) such as Architectural, Electrical, Mechanical, Piping and Structural and category layers representing content such as walls or windows. A building scene layer may contain an overview.

The concept of a group (i.e. layerType='group') has been added to organized sublayers into a nested tree structure that can be reflected in the table of content of 3D Clients. If a building scene layer does not contain an overview, the structure should not include an overview or full model, only the disciplines directly.

Please note that:

• Groups and sublayers may be referenced once (e.g. a sublayer may not be in multiple groups).
• Groups and sublayers do not have any resource associated with them.
• Sublayer resources are located in the sublayers of the building scene layer: layers/{bim_layer_id}/sublayers/{sub_layer_id}/....

Since a building scene layer may have an associated featureService, care must be taken to match building scene layer sublayer IDs with the service. In practice, if the building scene layer has n sublayers numbered [0,n-1] they need to match the featureService sublayers IDs. Any group layers ID in the scene layer need to be greater.

+-- layers
|  +-- 10 (3dSceneLayer.json for layer10, layerType ='building' )
|  |  +-- statistics
|  |  |   +-- summary.json
|  |  +-- sublayers
|  |  |  +--0 (3dSceneLayer.json for layer0, layerType='3DObject')
|  |  |  |  +--nodes
|  |  |  |  |  +--0
|  |  |  |  |  |  +--3dNodeIndexDocument.json
|  |  |  |  |  |  +--geometries (...)
|  |  |  |  |  |  +--attributes (...)
|  |  |  |  |  +--1
|  |  |  |  |  |  +--3dNodeIndexDocument.json
|  |  |  |  |  |  +--geometries (...)
|  |  |  |  |  |  +--attributes (...)
|  |  |  |  |  +--(...)
|  |  |  |  +--statistics
|  |  |  +--1 (3dSceneLayer.json for layer1, layerType='3DObject')
|  |  |  |  +-- (...)
|  |  |  +--(... , layerType='3DObject')

Building scene layer service:

The service definition is identical to other scene layer service definitions and will list a single layer (the BIM layer) e.g:

{
  "serviceName" : "Esri Campus",
  "serviceVersion" : "1.6"
  "supportedBindings" : "REST"
  "layers":
  [
    {
     "id" : 10,
     "layerType" : "Building"
     // ... 
     // building scene layer JSON definitions (see example below)
     // ...
    }
  ]
}

Notes on City scale building scene layer:

Building scene layer is envisioned to represent individual buildings or a campus composed of multiple buildings at one location. Even though you might be able to include a high number of buildings that are not co-located into a building scene layer, it is not recommended. If you want to represent city-wide buildings, you can create a single 3DObject layer that will be used as a placeholder to visualize and select a link to individual building scene layers. Once a building is selected, its matching building scene layer will be open.

Edits

• Group/layer names must be unique.
• Capabilities that have been removed.
  • sublayers.href and groups.href have been removed in favor of IDs.
  • Removed fullExtent from group object.
• Added back modelName.
• Added statistics.

Related:

bld::stats

Properties

Property	Type	Description
id	integer	Identifier for the layer. Building scene layer id is not in the same namespace as sublayer id. Important: clients should not assume it will be 0.
name	string	Layer name.
version	string	Version of building scene layer.
alias	string	Alias of the layer name. Can be empty if alias and name are identical.
layerType	string	Must be: Building
description	string	Description for the layer.
copyrightText	string	Copyright information to be displayed.
fullExtent	fullExtent	3d extent. If layer.fullExtent.spatialReference is specified, it must match layer.spatialReference.
spatialReference	spatialReference	The spatialReference of the layer including the vertical coordinate system. WKT is included to support custom spatial references.
heightModelInfo	heightModelInfo	An object containing the vertical coordinate system information.
sublayers	sublayer[]	List of sublayers or group of sublayers.
filters	filter[]	Array of filters defined for the building scene layer.
activeFilterID	string	Global ID, filter ID of the currently active filter for the building scene layer.
statisticsHRef	string	url to statistic summary for the BIM layer. statistics/summary.json

Note: properties in bold are required