Location Manager - User Guide & Reference

The Location Manager utility (Location category) Modeless dashboard designed to list, filter, and adjust spatial coordinate offsets and elevation parameters. Detects physical locations of elements (via LocationPoint, LocationCurve evaluation, or BoundingBox centroids), converts Revit internal units (feet) to millimeters, and allows batch coordination of elements by active view or level without blocking the main Revit session..

1. Overview & Key Capabilities

The Location Manager tool is designed to improve workflow efficiency by automating standard tasks. Key capabilities include:

• Modeless dashboard designed to list, filter, and adjust spatial coordinate offsets and elevation parameters.
• Detects physical locations of elements (via LocationPoint, LocationCurve evaluation, or BoundingBox centroids), converts Revit internal units (feet) to millimeters, and allows batch coordination of elements by active view or level without blocking the main Revit session.

2. Detailed Step-by-Step Usage

Follow these instructions to use the tool in your active Revit session:

1. Launch Location Manager to open the modeless window on your workspace.
2. Filter model elements by level, active category selection, or active view bounds.
3. Select target elements in the data grid to highlight them in the model view.
4. Modify X, Y, or Z coordinates directly in the grid, or apply batch offsets (e.g. shifts along Z axis).
5. Apply graphic overrides (color coding by elevation heights or levels) to check vertical coordination.
6. Click Commit to execute changes in a single safe API transaction.

3. Technical Specifications & Under the Hood

Revit API Integration

• Key API Components: Spatial coordinates parsing (LocationPoint and LocationCurve objects), UnitUtils translation of internal feet units to millimeters, and modeless UI updates.
• Transaction Handling: All modifications are packaged into a single Revit API transaction. If any error occurs, the changes are rolled back automatically to preserve model integrity.

[!TIP] Best Practice Tip: Ensure elements are correctly hosted before coordinates are modified, as coordinate shifts on unhosted elements might cause structural offsets.