Skip to content

SpatialInterfaceGeometryAttribute

HTTP API schema

Observed area of the group route in the coordinate system of its reference frame. Room shapes are a MultiPolygon: polygons are separate parts, later rings of a polygon are holes (furniture, obstacles, unmapped floor). Islands and holes under 0.05 square metres are map noise and are dropped. The shape is cached from the last map read: observedAt says when, and a FRESH report only means the cache was returned now, so re-read the device state for a newer map.

SpatialInterfaceGeometryAttribute fields

shapeSpatialShapeRequired
relativeToGroupIdstring

Reserved: the host does not fill it today, so it is omitted. Use relativeToGroupRouteId to compare a pose's frame with this geometry.

relativeToGroupRouteIdstring

Provider group route whose coordinate system the coordinates use. A device pose (spatial/pose) with the same relativeToGroupRouteId value uses this frame, so match on it to find the room the device is in.

observedAtstringRequired

When the provider observed this geometry

format: "date-time"

View source specification ↗