Skip to content

AreaUnit

The unit of measurement for areas displayed in the model.

SketchUp always computes areas in square inches internally, but displays them in whichever unit the user has chosen in Model Info > Units. Read the current setting from UnitOptions.areaUnit, or change it via UnitOptions.update.

let model = await SketchUpApi.getActiveModel();
let { AreaUnit } = SketchUpApi;
let units = model.options.unitOptions;
console.log(units.areaUnit);
// => 1 (SquareFeet)
// Change to square meters
await units.update({ AreaUnit: AreaUnit.SquareMeter });
let updated = await units.refresh();
console.log(updated.areaUnit);
// => 4 (SquareMeter)

UnitOptions for reading and updating the active unit

SquareCentimeter: 3


SquareFeet: 1


SquareInches: 0


SquareMeter: 4


SquareMillimeter: 2


SquareYard: 5