// the find
mapillary/mapillary-js
Interactive, extendable street imagery map experiences in the browser, powered by WebGL
MapillaryJS is a WebGL-based street-level imagery viewer built on top of the Mapillary platform. It renders 360° panoramas and perspective images with spatial awareness, supports custom data providers so you can feed it your own imagery instead of Mapillary's, and exposes an extension system for overlaying Three.js or raw WebGL content on top of street-level photos. Primarily useful for geospatial applications, mapping tools, or anyone building Street View-style experiences.
The data provider abstraction is well-designed — you can swap out Mapillary's API for your own imagery pipeline by implementing IDataProvider, which means you're not locked into their platform. The extension system (custom renderers, camera controls, geometry providers) is properly separated rather than bolted on. TypeScript types are thorough and the API surface is typed end-to-end. Documentation includes working theory pages on navigation graphs and polygon triangulation — rare for a project like this.
Hard dependency on Mapillary's graph API for any non-trivial use case means you're doing significant integration work to use your own data; the procedural data provider example helps but the contracts are complex. 507 stars for a Facebook-backed project after years of development suggests niche adoption, and the maintenance pattern (sporadic commits, last real activity in early 2026) raises questions about long-term support. The bundle size will be substantial given Three.js and WebGL shader code — no tree-shaking story is mentioned. If you're not building something geospatially oriented, this is the wrong tool; the component model and coordinate system assumptions are deeply tied to street-level imagery semantics.