Overlays

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 quite a few options in the Library, and Admins and Members can upload their own custom overlays, such as building envelopes, photo points, trails, and more.

Overlays in the Lens Library

Every Lens account 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, then Lens Library. From here, Admins or Members can add overlays to portfolios. Use the "Filter by" tool at the top of the page to view overlays only, or look for the "Layer" or "Overlay" text on each dataset's tile card to understand which is which. Once added to a portfolio, the overlay will be available to be used in the properties within that portfolio. There's more information on how to view overlays on a property below.

Here are the Overlays we currently have in the Library, 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 with Standard and Enterprise plans, 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.
  • Native Land Territories is an open dataset developed by Native Land Digital, an Indigenous-led nonprofit based in Canada. This overlay maps Indigenous territories and is intended to shed light on the history of colonialism, Indigenous ways of knowing, and settler-Indigenous relations. Territories are shown globally where data is available. It does not represent or intend to represent official or legal boundaries of any Indigenous nations. Any conflicting territorial claims err on the side of being more expansive. To learn about definitive boundaries, contact the nations in question, which are linked in the Overlay details on hover.  
  • Electric Power Transmission Lines: This dataset shows transmission lines for the electric power grid within the continental United States. It is provided by the US Department of Homeland Security Geospatial Management Office's Homeland Infrastructure Foundation-Level Data Portal. 
  • Natural Gas Pipelines: This dataset includes the major natural gas transmission pipelines in the United States including interstate, intrastate, and gathering pipelines. Data was obtained by the U.S. Energy Information Administration and last updated in June of 2019. It is made available by the U.S. Department of Homeland Security Geospatial Management Office's Homeland Infrastructure Foundation-Level Data portal. Upon hover, you'll see the pipeline operator and type of pipeline (Ex: interstate, intrastate) as context. 
  • US Protected Areas: This overlay includes protected conservation areas at the national, state and local level as well as easements as of June of 2023. It is derived from the USGS Protected Areas Database of the U.S. (PAD-US) and includes public lands and parks, Wilderness Areas, National Wildlife Refuges, reserves, conservation easements, Marine Protected Areas, and more. This data is provided by the U.S. Department of Homeland Security Geospatial Management Office's Homeland Infrastructure Foundation-Level Data portal.
  • Massachusetts Wetlands Inventory: The National Wetland Inventory (NWI) is a comprehensive geospatial database maintained by the United States Fish and Wildlife Service (USFWS) that provides detailed information on the location, extent, type, and condition of wetlands across the United States. The Wetlands Data Layer is the product of over 45 years of work by the National Wetlands Inventory (NWI) and its collaborators and currently contains more than 35 million wetland and deepwater features. Massachusetts wetland areas have been updated between 1975 and 2013, depending on the part of the state.
  • EPA Superfund Sites: The EPA’s Superfund program is responsible for cleaning up some of the nation’s most contaminated land and responding to environmental emergencies, oil spills, and natural disasters. This dataset contains polygons showing the extent of Superfund sites, or areas polluted with hazardous materials. Superfund features are managed by regional teams of geospatial professionals and remedial program managers. The name of each site and a short description are shown on hover. Data is provided by the U.S. Environmental Protection Agency (EPA).
  • WWF World Terrestrial Ecoregions: The WWF Terrestrial Ecoregions of the World data is a biogeographic regionalization of the Earth's terrestrial biodiversity. Our biogeographic units are ecoregions, which are defined as relatively large units of land or water containing a distinct assemblage of natural communities sharing a large majority of species, dynamics, and environmental conditions. There are 867 terrestrial ecoregions, classified into 14 different biomes such as forests, grasslands, or deserts. Ecoregions represent the original distribution of distinct assemblages of species and communities. Learn more about this dataset here.
  • Biodiversity Hotspots: These are the biologically richest but most threatened areas on the planet. Each hotspot contains at least 1,500 plant species found nowhere else on the planet and has lost at least 70 percent of its original primary vegetation. Taken together, remaining natural habitats within the 35 biodiversity hotspots cover only 2.3 percent of the Earth’s land surface, yet they support nearly 60 percent of the world’s plant, bird, mammal, reptile and amphibian species.
  • Intact Forest Landscapes: The Intact Forest Landscapes dataset from Global Forest Watch identifies the world’s last remaining unfragmented forests, critical for retaining native biodiversity and essential habitats. This data tracks changes over the last two decades. Ideal for carbon project diligence and biodiversity assessments, this dataset provides invaluable insights into the conservation value of these vital ecosystems. There are currently datasets available for the years 2020, 2016, 2013, and 2020 in the Lens Library.

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.

You can click on an overlay feature so that the hover information remains, allowing you to copy and paste this information. You can click the feature a second time to un-stick the information and freely hover over other overlay features. 

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.
  • The overlay file must contain fewer than 1000 features.

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

Once you click "Add an 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. You can download your custom overlays from the overlay library page. 

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, you can delete the outdated overlay and re-upload a current one.

Overlays in Reports

Overlays can be helpful to include in a report to add context to an area of interest you're monitoring. Any overlay that is enabled to be visible by default will automatically be shown in a report that's generated in Lens. 

When editing a report, click the layer icon to hide or show an overlay on an image, as shown below.