Butlr におけるZoneとRoomの違いについて

概要

Butlrセンサーを設定する際には、ZoneとRoomの違い—および重なり—を理解することが重要である。どちらもプレゼンスの検知に使用できるが、ButlrダッシュボードおよびAPI内では異なる機能を持ちます。

名称にかかわらず、ZoneとRoomは階層構造ではない—つまり、どちらかが他方を含むことはない。これらは当社の空間モデルにおける別個の並列オブジェクトであり、それぞれ異なる目的を果たします。Butlrの空間データ構造の詳細については、Data Model Hierarchyを参照してください。

Roomについて

Roomとは、オフィス、会議室、寝室など、現実世界における物理的に区切られた空間を指します。

センサーが割り当てられ、データが集約される基本的な空間単位です。

主な挙動

• 各センサーは、1つのRoomにのみ所属できます。
• プレゼンスモードおよびトラフィックモードの両方のセンサーは、割り当てられたRoomにデータをレポートします。

• Roomの境界は、センサーの視野（FOV）を切り取ることはありません。センサーの中心点がRoom内にある限り、そのセンサーのFOV全体がそのRoomの占有データに反映されます。

   

Zoneについて

Zoneとは、より詳細なモニタリングのために大きな空間を分割する仮想エリアです。

例えば、デスクの集まり、座席エリア、出入口ゾーンなどが該当します。

主な挙動

• センサー自体はZoneに割り当てられません。Zoneのデータは、Zone境界とセンサーのFOVが重なっている部分から生成されます
• Zoneの境界はセンサーのカバー範囲を切り取ります。Zone内で検出されたものだけがZoneデータとしてカウントされます
• Zone同士は重複させることが可能です（例：チーム単位のクラスタ、複合的なアクティビティエリア）
• Zoneデータに寄与するのはプレゼンスモードのセンサーのみであり、トラフィックモードのセンサーのデータはZoneレベルでは無視されます

Zoneを使用する場面

• センサー視野の一部のみを細かく検出したい場合（例：特定のデスクや座席エリア）
• 複数エリアをグルーピングまたは比較したい場合（例：部門クラスター、会議エリアなどの重複領域）

主要な違いの一覧

よくある誤解

• 「ZoneはRoomに属さなければならない」 → 誤り。Zonesは独立しており、Roomの内部にネストされていないです。
• 「Roomの境界はセンサーのFOVを切り取る」 → 誤り。センサーの中心がRoom内にある場合、FOV全体が寄与します。
• 「トラフィックモードはZoneと連携する」 → 誤り。Zoneレベルのデータはトラフィックモードのセンサーを無視します。

• 「Zoneデータは自動的にRoomデータにロールアップされる」 → 常にではないです。データ集約はRoomとZoneの境界の整合性に依存します・

   

設置する人への情報

✔️ トラフィックモードを使用する場合は、必ずセンサーをRoomに割り当てます

✔️ 使用パターンを反映するようにZoneを明確にラベル付けします（例: Desk_12_East, FocusArea_B）

✔️ デスクをチーム、エリア、使用タイプ別にグループ化するために、重複するZoneを慎重に使用します