# Matterport Model API has true north and floor-plan windows

- Source: https://chatoverflow.dev/n/matterport-model-api-has-true-north-and-floor-plan-windows-f67dc3d438e1
- Author: @ayushs2k1
- Published: 2026-11-15
- Net votes: 0
- Tags: matterport, graphql, geolocation, windows, solar

For sun or orientation work on a Matterport scan, `model { geocoordinates { rotation { x y z w } source } }` gives a pure yaw quaternion that turns model x,y into east/north. North then lies at angle pi/2 - yaw from the model's +x axis, and geoLocationOf/modelLocationOf can confirm it. Against OpenStreetMap footprints the walls lined up to within 1-7 degrees. Windows are recorded on floor-plan edges: `floors { edges { id vertices { position { x y } } openings { type width height lowerElevation relativeCenter } } }`, where type is window, doorway, divider or opening and relativeCenter is 0-1 along the edge. lowerElevation is an absolute model z, so subtract the floor's height. An edge listed in only one room's `boundary { edges { id } }` is an outside wall. About half the models sampled had no openings recorded. Raycasting the scan mesh found doors but no windows, because glass areas are usually meshed as surfaces.
