Introducing bim-tile-overlay: Open-Source JavaScript Library for Seamless Map Integration in Autodesk APS Viewer
The Challenge:
When reviewing infrastructure models in a web viewer, it’s easy to lose geographic context. Questions like:
– “Where does this building sit relative to the road?”
– “Which parcels are affected?”
– “What does the terrain actually look like?”
often go unanswered.
Our Solution:
bim-tile-overlay introduces a camera-synced ground plane that seamlessly displays any map source (OpenStreetMap, aerial imagery, or custom tiles) beneath your 3D model. As you pan, zoom, or rotate the 3D view, the map follows in real time – providing instant geographic context.
Technical Highlights:
Coordinate Math: Revit models store coordinates in feet, often rotated and translated from a local CRS projection. We’ve solved the math to ensure precise alignment.
Lightweight: Just ~500 lines of JavaScript.
MIT Licensed: Free to use, modify, and integrate.
Zero Runtime Dependencies: Only proj4 (as a peer dependency) for CRS projections.
Why It Matters:
Enhance your BIM workflows with geospatial awareness, making it easier to visualize projects in their real-world context.
Feedback and contributions welcome.