Find Entities in Region
analysis_find_in_regionRead-only
Find all entities inside a rectangular area by specifying the region bounds (min/max X, Y). Optionally project fields or use compact output to control result size.
Instructions
Find all entities within a rectangular region (crossing selection).
Uncapped: a window over a busy drawing returns every hit. Project with
fields and/or compact before widening the window.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x1 | Yes | Region minimum X | |
| x2 | Yes | Region maximum X | |
| y1 | Yes | Region minimum Y | |
| y2 | Yes | Region maximum Y | |
| fields | No | Project to these fields, in this order (e.g. ['handle','type','layer']); 'properties.<key>' reaches one nested value. Omit for the full record; an unknown name errors and lists the valid ones. | |
| compact | No | Return a columnar {fields, rows, count, offset, total, truncated, next_offset} envelope instead of dicts: much cheaper per row, and the only shape that reports truncation. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |