This article covers:

Overlays are vector data that can be displayed on top of the map in Lens. These can be points, lines, or polygons. We offer a few options in the Overlay Library, and Admins and Members can upload their own custom overlays, such as building envelopes, photo points, trails, and more.

Overlay Library

Out of the box, Lens comes with an Overlays Library with options that can be added to your portfolios. To get there, click here or navigate to the settings page where you’ll see Overlays beneath the Lens Library. From here, you can check out Featured Overlays. Admins or Members can add these to portfolios. Once added, they’ll appear in the Your Overlays section below, where you can choose which portfolios they should appear in by default. 

Here are some of the Overlays we have in the Library now, and would love to hear any ideas you have as we continue adding to this list.:

  • Parcel Data from Regrid pulls parcel data from across the US directly into Lens, allowing you to easily check tax parcel ownership. This layer is available to our Plus and Enterprise users, and shows the parcel ID, owner, and address on hover. 
  • Flowlines come from the USGS National Hydrography Dataset for linear surface water drainage network across the US, and can be useful if you’re interested in monitoring areas with streams or rivers 
  • Microsoft Building Footprints is an open dataset developed by Microsoft Maps and Bing Maps showing building footprints datasets in the US. This dataset contains nearly 130 million computer generated building footprints derived using our computer vision algorithms on satellite imagery.

Viewing overlays on the map

To view or hide overlays, click on the relevant layers from the “Change Overlays & Basemaps” button in the right sidebar to select or unselect each one. Overlays can be set to be visible or hidden by default via the settings icon on the overlay. These appearance preferences will be applied the next time you load a property in the portfolio.

You can also set your colors and fill preferences by clicking on the colorful polygon next to each overlay, as shown below.

Adding custom overlays

Areas of interest such as building envelopes, timber areas, trails, etc. can be added to your portfolio as custom overlays on your properties. These vector data can be points, lines, or polygons. 

To add your overlays to Lens, we require shapefiles to follow these guidelines:

  • One shapefile per overlay type. This means that if you need to add building envelopes and trails (two separate overlay types), you will need to provide two separate shapefiles. Each overlay can cover multiple properties within the same portfolio 
  • The shapefile must have a valid projection (WGS 84 projection preferred).
  • The property boundaries must have no self-intersections or invalid geometries.
  • Include only 2 dimensional coordinates - see this resource if you need help removing a "z" coordinate

You can upload overlays to your Lens account via the Overlay Uploader, which can be accessed from the overlays library settings page.

Once you click "Add Custom Overlay", you'll be prompted to select a file that meets the format criteria above. Once you've selected a file, you can edit the name of the overlay and choose an attribute to appear on hover.

Once you confirm the upload, you'll be sent to the overlay library page where you can select which portfolios the overlay should appear on. Further customization of the overlay's appearance will take place on the map page, as elaborated on in the above section

In the image below, the overlay name is "DEP Wetland" and the name of the attribute displayed on hover is "Cranberry bog".

Updating overlays

To update an existing overlay in Lens, send the updated master shapefile to us at lens@upstream.tech. Please include which attribute field you'd like to appear on hover.