v1.0.0
    Avvir

    Avvir Case Study

    360º Site Photos, Pinned to the Floor Plan

    Avvir is a New York construction-technology company. Its software compares scans of a building under construction against the design model, so builders can track progress and catch deviations early. In 2019, co-founder and CEO Raffi Holzer and Cory M Burnett, who led the product work, brought Blood & Treasure in to add 360º site photos to Avvir's web viewer.

    Avvir showcase

    Challenge

    Avvir wanted a project manager or superintendent to be able to open a 360º photo from the floor plan, look around the space and drop an observation on the exact spot that needed attention, with a title, a comment thread and an author.

    Avvir's own engineers were busy with the core scan-processing and API work. They needed a team to build the front end of the 360º experience inside their existing React codebase while they built the matching APIs.

    After walking through the designs with Raffi and Cory in May 2019, we reviewed the codebase and the backlog and scoped the work: a floor-plan minimap, photo markers on it, a full-screen 360º viewer with zoom and rotate, and observations placed in the photos.

    Avvir detail

    Development & Implementation

    What We Built

    • 360º photo viewer. A full-screen panorama viewer built on Three.js and embedded in Avvir's React web app, with drag-to-rotate, scroll and button zoom, and a lock mode that holds the view steady while you read pins.
    • Observation pins. Clicking anywhere in a photo drops a pin and opens a title and comment dialog. The pin stays fixed to that point as the user rotates and zooms.
    • Comment threads. Each observation holds comments with their author and date, loaded alongside the observations from Avvir's API.
    • Floor-plan minimap. A collapsible, zoomable and draggable minimap shows where each 360º photo was taken. Clicking a dot jumps to that photo.
    • Cube-map panoramas. The viewer started with single-image panoramas, then added six-face cube maps when Avvir's real capture data arrived in that format.
    • API integration. The viewer is wired to Avvir's 360º image, minimap and observations endpoints, and we worked with their team on the API's shape.
    • Customer demo. We deployed a working prototype so Avvir could show it to a customer ahead of the full integration.

    How It Works

    Panoramas in Three.js. Each 360º photo renders as a texture inside a Three.js scene, embedded as React components in Avvir's existing web app.

    Pins in 2D and 3D. When a user clicks, the viewer converts the screen position into a point on the panorama image and into a direction in 3D space. Both are saved with the observation, so pins render in the right place without recalculating, and the same data can later be shown on the 3D building model.

    Built ahead of the API. We first built the components on a test route with sample data in the shape of the planned API, which kept the work moving while the endpoints were finished. We then moved them into the project viewer and pointed them at the live endpoints.

    Handed over cleanly. We delivered the code as branches and a pull request on Avvir's GitHub, with fully specified stories for the next phase, and Avvir's team took over the final integration.

    Avvir feature

    Results

    We took the 360º viewer from kickoff to a working prototype in about nine weeks, from June to early August 2019. Avvir showed it in a customer meeting that August.

    All code was in Avvir's repositories by September 2019 for their team to finish the integration. Avvir was later acquired by Hexagon.

    Location:

    New York, NY

    Tech Stack:

    Front end

    • React
    • Three.js
    • Webpack
    • Yarn

    Back end

    • Avvir REST API

    Infrastructure

    • Heroku
    • GitHub

    Design and planning

    • InVision
    • Sketch
    • Pivotal Tracker

    Features:

    • 360º Viewer: Full-screen site panoramas with rotate, zoom and a lock mode.
    • Observations: Pins dropped on the exact spot in a photo, with a title and comments.
    • Minimap: A floor plan showing every photo location; click to jump.
    • Cube Maps: Six-face cube-map panoramas as well as single-image ones.
    • 2D and 3D Coordinates: Each pin stored in image space and in 3D space, ready for the building model.
    • API Integration: Connected to Avvir's 360º image, minimap and observations endpoints.

    Achievements:

    • Working prototype in about nine weeks from kickoff
    • Shown to an Avvir customer in August 2019
    • Code handed over to Avvir's GitHub for in-house integration
    • Avvir later acquired by Hexagon

    Still have questions?

    Talk to Devin, our AI assistant, for instant answers about our services.