How to get the available areas using the API

Guide

Before you start, remember to:

Add the Ubisense references to your application

Create an instance of the Ubisense.UBuilding.Contents schema with instance name build_contents_schema and connect to the schema as a client.

The Ubisense.UBuilding.Contents.AreaProperties relation contains the basic properties of an area.

You can iterate over this relation using the area_ or name_ methods that return unique indices. For example,

    using (Ubisense.UBuilding.Contents.ReadTransaction xact =
        build_contents_schema.ReadTransaction())
    {
        foreach (Ubisense.UBuilding.Contents.AreaProperties.RowType row in
            Ubisense.UBuilding.Contents.AreaProperties.name_(xact))
        {
            // row.area_ contains the area in question

            // row.description_ contains a human-readable description of the area

            // row.extent_ contains a right-polygonal prism
            //            describing the extent of the area

            // row.name_ contains the human-readable name of the area
        }
    }

Note that the cache query method outlined above is preferable to using the remote procedure calls outlined below. This is because querying a local cache gives predictable scalability.

Alternatively, you can use the get_area method or the get_all_areas method of your build_contents_schema instance. For example, use get_all_areas as follows,

List<Ubisense.UBuilding.Contents.AreaProperties.RowType> area_list;
build_contents_schema.get_all_areas(out area_list);

area_list now contains a list of all the rows in the Ubisense.UBuilding.Contents.AreaProperties relation.

How to get the available areas using the API

Summary

Prerequisites

Example material

Guide