MassMapper User Guide

MassMapper was created by the Bureau of Geographic Information (MassGIS) as a modern replacement for the long-used Oliver online mapping application. It provides access to virtually all the MassGIS map layers and associated descriptive information, which can be displayed and queried. Users can quickly create and share maps and download data for use in a Geographic Information System (GIS) or export tabular data as Excel or CSV files.

*Please note: MassMapper is one of a family of applications, all built on the same template. Some of the other versions include MuniMapper that was created for Massachusetts Municipalities upon request. This user guide applies to all these applications, so you may substitute "MuniMapper," etc. for MassMapper as you read this guide.

 

TABLE OF CONTENTS

Getting started Tools Searching for a location Navigating the map Adding data layers Adding data layers by searching - New Features! Data layers with scale dependencies Reordering data layers Customizing data layers Customizing the map Removing data layers Viewing metadata Identifying features - using the single identify tool Identifying features - using the select by polygon tool Measuring length or area Drawing shapes and adding text - New Features! Creating a buffer - New Features! Copy coordinates - New Features! Creating an abutters list Bookmarking/sharing a map Zoom to a parcel - New Features! Downloading data - New Features! Saving a map as a PDF - New Features! Problems? Questions? Comments?

 

 

Getting started

 

What do I need to run MassMapper?

MassMapper is run in a web browser. Currently, the application fully works in Google Chrome, Microsoft Edge, Mozilla Firefox, and Safari. The latest versions of these browsers are recommended. Other web browsers may also be able to run MassMapper.

Start MassMapper

You will see a splash screen with some introductory info. Click on to dismiss the splash screen.

You may also choose to not see the splash screen again by checking this box. However, if MassGIS needs to post pertinent info about MassMapper, it will be posted on the splash screen and any changes to the text will force the splash screen to reappear.

Initial view of the MassMapper application:

Table of Contents

 

Tools

 

Please note: The Abutters List Tool is only displayed in MuniMappers.

Tools at the top and the left side of the map

Zoom in/Zoom out - Most navigation can be accomplished with a wheeled mouse. To move the map sideways (pan), simply hold your left mouse key down and drag to recenter the map. To zoom in, scroll your mouse wheel forward. To zoom out, scroll the wheel backward. If you do not have a wheel on your mouse, you will need to use these plus/minus tools. Or hold your shift key while dragging a box around a specific area to zoom in to.

Go back to previous extent - Click this button to go back to the previous map extent.

Go to next extent - Click this button to go forward to the next map extent.

Help - Click this button to view this help documentation.

Identify features by clicking on a feature - Click this tool then click on the map to identify features of active data layers that intersect the location you clicked. The identify results will appear in a pop-up window.

Identify features by drawing a shape - Click this tool then click on the map multiple times to draw a shape. Click on your starting point to close the shape. The identify results will appear in a pop-up window for all the features within your shape.

Measure by length or area - Click this tool to view the measure menu. Click either radio button for Length or Area. Then using the dropdown menus, choose your units. Step by step details are further below.

Permalink - Click this tool to make a permalink for the map. A copy of the URL used to create the map you've constructed will be copied to your clipboard for pasting elsewhere.

Abutters List - (Only available in City or Town based Municipal Mappers (MuniMapper)) Click this tool to launch the abutters list function. Enter a distance and select units (feet or meters) from the dropdown, then click on the subject parcel to get a list of abutters in the popup that can be exported as an Excel, CSV or Shapefile (for use in GIS software). You can grab and move the popup to see the buffer polygon used to select the abutters.

Draw tools and Buffer - Click this tool to see several drawing options. You can draw a point, line or shape using the colors, styles and thicknesses presented. You can also add text to the map. A buffer circle can be drawn - enter a distance and select units (feet or meters) from the dropdown, then click on the map. These drawn features will not carry through in a permalink but will be on a map you print.

Print or save your map and legend as a PDF - Click this tool then enter the title that you want to appear on the top of your PDF map. You have the option of naming the PDF file. The default is massmapper.pdf. 2 page sizes are available. Click the print map button then the PDF will be downloaded to your Downloads folder.

Export data layers (for use in GIS) - Download zipped GIS files for the data layer features on your map for use in GIS software. Or export the tabular information.

Enter a location -  Type an address into the box and hit Enter. Click on the single result to zoom to the location. You can also search on city and town names, and in some cases, neighborhood names or major landmarks. This location feature is provided by MassGIS.

Basemaps - Hover over this tool to see choices to change the basemap. The latest MassGIS aerial imagery will always be a choice. Use the layers from the Images folder to see older vintages of aerial photos. The opacity of basemaps can be changed. Some of the basemap choices may change over time.

Map units - You can choose to display map coordinates in four different ways; the default is Longitude/Latitude as Decimal Degrees (DD). Use the dropdown to change units to Longitude/Latitude as Degrees Minutes Seconds (DMS), MA State Plane Mainland Meters, or MA State Plane Mainland Feet. The coordinate shown changes as your mouse moves. The coordinate can be copied (for pasting) from the Draw tools / Draw Points section.

Table of Contents

 

Searching for a location

 

In the Enter a location box, type in any of the following:

• Full address with number, street name and city/town or ZIP Code
• Street name and city/town
• Point of interest or landmark
• Municipality or village/neighborhood
• ZIP Code
• Longitude, Latitude

Then hit Enter on your keyboard.

The single, best result will appear. Click on that to zoom to the location. Text may be entered in lower, upper, or mixed case. All results are in Massachusetts and "MA" should not be included for best results. Some misspellings are tolerated.

If no result is close enough, "No matches found" will appear.

*** To improve the chances that you will get your desired result, include the city/town name or ZIP Code for common addresses and place names that may be duplicated in multiple communities.

Here are some examples:

For addresses, enter the number, street name, and city/town or ZIP Code:

An address without a city/town may not return a match:

You can also enter a street name and city/town without a house number:

And you can enter a city/town name or 5-digit ZIP Code by themselves:

For well-known placenames with unique names, community may not be required:

For placenames with non-unique names, enter a city/town or ZIP Code to be sure you get the correct result. For example, there are several Great Hills in Massachusetts:

If you enter "Great Hill" alone, the tool will randomly pick one (in this case the one in Shelburne):

By entering "Great Hill, Acton" the tool will return that specific result:

Similarly for villages and neighborhoods, the name may not be unique. For example, there is more than one Centerville. Entering that name alone found the one in Winchendon. To find the one on Cape Cod, include the official municipality name of Barnstable:

For longitude and latitude, longitude must be first and include a minus sign, and be followed by a comma:

To provide this service MassGIS collected information from many of the existing datalayers in its catalog, such as schools, colleges, prisons, hospitals, historic buildings, town halls, etc. In addition, data from OpenStreetMap was collected which enhances the service with additional detail such as businesses.

If you find something missing from the location service that should be included in a MassGIS datalayer let us know. If the missing item is not a MassGIS datalayer, we suggest that you include it in the OpenStreetMap project and when our service is next updated, it will be harvested by us. If you're not sure, let us know.

Table of Contents

 

Navigating the map

 

Most navigation can be accomplished with a wheeled mouse. To pan, simply hold your left mouse button and drag to recenter the map. To zoom in, scroll your mouse wheel forward. To zoom out, scroll the wheel backward. If you do not have a wheel on your mouse, you will need to use the plus/minus tools.

Go back to previous extent - Click this button to go back to the previous map extent.

Go to next extent - Click this button to go forward to the next map extent.

To zoom to a very specific area, hold the shift key while dragging a box by holding your left mouse key to define a box to zoom into.

Table of Contents

 

Adding data layers

 

1. On the right-side column is a category listing of map/data layers preceded by a right facing arrow >. By clicking your category of interest, sub-menus will open. Drill down until you find your layer of interest, which will be preceded by a symbol that indicates the layer's geometry type: points , lines , or polygons , or rasters (tiles).
2. Click a data layer name to add it to the map.
3. The data layer is drawn on the map. The data layer name and its legend will appear in the Legend Area window.

   
   
   

Table of Contents

 

Adding data layers by searching

 

In the upper right, click in the Search for a layer box.  New: The box now stays open at all times so it is more visible.

If you simply click in the Search for a layer window, you will see an alphabetical listing of available data layers that you can scroll through, click on a layer of interest to have it render.

Or you can start typing search terms. The MassGIS datalayer web page lists all available layers. The category sections on that page loosely mirror the section categories in MassMapper. In the example below, Counties is being called for.

Table of Contents

 

Data layers with scale dependencies

 

Most data layers have scale dependencies and are only visible within certain scale ranges, such as less than 1:100,000. If a data layer has a scale dependency and the map is not within the appropriate scale range, the data layer will not draw on the map and this icon will appear next to the layer name. To view the data layer, zoom in. Some of the basemaps also have scale dependency and will be dimmed/unavailable at small scales (zoomed way out) and you'll need to zoom in and then add that basemap.

Table of Contents

 

Reordering data layers

 

Data layers are drawn from the bottom to the top of the Legend Area, and they appear layered in that order on the map. To reorder the data layers, click on a data layer name in the Legend Area, hold down the mouse button, and drag the data layer name up or down in the list.

Table of Contents

 

Customizing data layers

 

After adding a data layer, you will see the Customize Layer Settings button , click that to expose several functions related to that layer.

Symbology: MassGIS has created sensible legends for each data layer. However, the user can change the color of point, line, or polygon data layers in the legend area. Click a data layer's settings icon in the legend area, move the mouse cursor over "Custom Color" and select a color option. Points will be drawn as squares in the color you selected, lines will be drawn with the color you choose, and polygons will be drawn with a gray outline and filled in with the color you picked. Keep in mind that there is no way to use different colors for different features in the same layer; either use the default legend that may have many colors or select your own single color.

Opacity Slider: The opacity (solid to transparent) of active data layers may be changed. Click preceding the layer name, see the opacity slider , hold down the mouse button on the green dot, and drag the slider to the desired opacity. The percentage of opacity will appear in the green pin and will appear on your map once you release the mouse. Data layers with 0% opacity will be completely transparent and data layers with 100% opacity will be opaque.

Table of Contents

 

Customizing the map

 

Map units: When the cursor is over the map, the longitude and latitude of the cursor's location are displayed in the lower right-hand corner of the map. To change the units of the longitude and latitude, click the dropdown on the Map units bar in the lower right to view a menu and select one of the listed options.

Basemaps: To change the basemap, hover over the "Basemaps" button in the upper right to view a menu and select one of the listed options. This map will always appear below any other added data layers and can only be removed by selecting a different basemap. A dimmed basemap title in the list indicates it is scale dependent and you'll need to zoom in to see it. The opacity of the basemap can be changed by using the slider. Depending upon availability, the options may change over time.

 

Table of Contents

 

Removing data layers

 

To temporarily turn a data layer off, uncheck the box next to the data layer name in the legend area window.

To remove a data layer, click the trash can icon next to the layer name.

Table of Contents

 

Viewing metadata

 

Metadata is text documentation about a data layer and is available for virtually all data layers in MuniMapper. To view a data layer's metadata, click the hyperlinked name of the layer once you have added it to the legend area. This page on the MassGIS website hosts all the metadata pages and the section categories there loosely mirror the top categories of the available data layers in MassMapper.

Table of Contents

 

Identifying features - using the single identify tool

 

This tool is used to click a feature on the map to see the details (textual description) of that feature. This tool will only identify layers in the legend area and will not identify features in any basemap as the basemap is merely a picture. Click the "Click to identify a feature" tool.

1. Click on the identify a feature tool, then click on the map to identify features of added data layers that intersect the location you clicked.
2. A pop-up window will appear with the identify results. You may view the attributes for up to 500 features per data layer. Please note that some data layers have scale dependencies and are only visible within certain scale ranges, such as less than 1:100,000. If a data layer has a scale dependency and the map is not within the appropriate scale range, then the data layer will not draw on the map, this icon will appear next to the layer name legend area.
3. In the popup to view the feature details of a point, line, or polygon data layer, click on the data layer name in the "Identify Results" table. Attributes for the selected data layer will appear in the bottom half of the popup. The data field names are slightly bolded at the top of each column. The columns may be widened by hovering and clicking on the divider to pull right. The specific feature details are in the column. Hovering over a field value will provide tool tip text of the entire value. With most detail records, you'll need to use the scroll bar to scroll right to see the entire record. Change the size of the popup using this tool in the upper right .
4. The attribute tables can be manipulated in many ways. Select records from the set by checking the box preceding each record. Sort on any of the fields by clicking the 3 dots in the column header (or use the sorting arrow next to the dots).
5. Selected records or all records can be exported as an Excel, CSV or Shapefile.
6. Close the Identify results window and then click the tool to clear blue shape from the map.
   
   

Table of Contents

 

Identifying features - using the select by polygon tool

 

This tool is used to draw a shape around features of interest to see the details (textual description) of those features in a table. The tool will only identify layers present in the legend area and will not identify features in any basemap as the basemap is merely a picture.

1. Click on the draw a polygon tool. In the map use your cursor to click multiple times to draw a shape around your features of interest and close the shape by clicking back on the first point.
2. A popup window will appear with the identify results. You may view the attributes for up to 500 features per data layer. Please note that some data layers have scale dependencies and are only visible within certain scale ranges, such as less than 1:100,000. If a data layer has a scale dependency and the map is not within the appropriate scale range, then the data layer will not draw on the map, this icon will appear next to the layer name legend area.
3. In the popup to view the feature details of a point, line, or polygon data layer, click on the data layer name in the "Identify Results" table. Attributes for the selected data layer will appear in the bottom half of the popup. The data field names are slightly bolded at the top of each column. The columns may be widened by hovering and clicking on the divider to pull right. The specific feature details are in the column. Hovering over a field value will provide tool tip text of the entire value. With most detail records, you'll need to use the scroll bar to scroll right to see the entire record.
4. The attribute tables can be manipulated in many ways. Select records from the set by checking the box preceding each record. Sort on any of the fields once your cursor is in the field name area by clicking the 3 dots in the column header (or use the sorting arrow next to the dots). Change the size of the popup using this tool in the upper right .
5. Selected records or all records can be exported as an Excel, CSV or Shapefile.

6. Close the Identify results window by clicking the X and then click on the tool to clear blue shape from the map.
   
   

Table of Contents

 

Drawing shapes and adding Text

 

1. Click the "Draw" tool. The following popup will appear.
   
2. Select lines, points or text.
3. Select type.
4. Select size.
5. Select color.
6. Click the map to place the shape or text.
7. To erase all shapes and text, click on the Clear at the bottom of the pop-up.

Table of Contents

 

Creating a buffer

 

1. Click the "Draw" tool. The following popup will appear.
   
2. Choose Add Buffer.
3. Enter length.
4. Choose units.
5. Select color.
6. Click the map to indicate the center of the buffer circle.
7. To erase all shapes and text, click on the Clear at the bottom of the pop-up.

Table of Contents

 

Copy coordinates

 

1. Click the "Draw" tool. The following popup will appear.
   
2. Choose Draw Point.
3. Click the map to draw a point.
4. Coorindates can be copied from the box.
5. To erase all shapes and text, click on the Clear at the bottom of the pop-up.

Table of Contents

 

Measuring length or area

 

1. Click the "Measure" tool. Select the radio button for Length or Area. The following popup will appear.
   
2. Select your units from the dropdown. Length measurements can be in Feet, Meters or Miles. Click in the map at the start of your measurement. If you are measuring a line that bends, click each vertices point. When your measurement is complete, double click to see the results on the empty line in the image above. You can change the units of the line you just measured using the units dropdown. Click the measure tool to close the measure popup and erase the line.
3. For Area, select the radio button and your units, Square Feet, Acres, Square Meters, and Square Miles. Click in the map to measure your area. Your last click should close your shape. The results will appear in the empty line in the image above. You can change the units of the area you just measured using the units dropdown. Click the measure tool to close the measure popup and erase the shape.

Table of Contents

 

Creating an abutters List

 

The abutters list tool is available only in Municipal Mappers and will generate a list of property owners within a certain distance that you input. The list can be exported as Excel, CSV, and Shapefile formats.

Navigate to your property of interest. The only default data layer, Property Tax Parcels should appear. For clarity, remove any other layers.

1. Click the tool .
2. In the popup, input the distance (ex. 100 or 500). Use the dropdown if you want Meters (m) otherwise, leave as it as Feet (ft).
3. Click on your property of interest.
4. A popup will appear. This can be moved by clicking and dragging the popup to the side to see the polygon that was generated to select the parcels whose records now appear in the popup. This table has all the functionality of the other Identify tables: Select specific feature records, widen the columns, hide, and sort, etc. Change the size of the popup using this tool in the upper right .
5. All features or just selected features can be exported as Excel, CSV or Shapefile. Make your format selection after clicking the export button.
6. Click on the download link and the file will be downloaded.





*Users should be aware that in the case of multiple owners on a single condo property, only one property parcel may be selected but the multiple owners will be listed in the abutters list results. A single parcel with multiple condo owners will be a darker orange color, whereas parcels with single owners will be a more transparent orange.

Table of Contents

 

Bookmarking/Sharing a Map

 

Using Permalink button:

1. To create a bookmark to launch the application with the current map settings (e.g., data layers, extent, etc.) enabled, click the "Permalink" tool.
2. Doing so will copy the URL of the current map to your clipboard. Share that with someone via email. Or create a document where you store these very long URLs. Click OK to dismiss the popup.
   
   
   
   Please note: Some software programs, such as Microsoft Outlook, limit the number of characters allowed in a URL. If the permalink URL exceeds the maximum allowed length, the link will not open automatically when clicked. Copy and paste the URL into a web browser to open it. Also, if you used the draw tools to add text or lines, those will not carry over in the permalink. Use the print as PDF tool if you need text or lines to be saved.
   
   

Table of Contents

 

Zoom to a parcel

 

It's possible to create a URL that will zoom immediately to a parcel when MassMapper is launched. To add zoom to a parcel functionality to a simple MassMapper URL (non Permalink), use ?locid=value   The locid is a unique parcel identifier. If the URL is a full Permalink, the locid will override any bounding box "b" parameter in the URL.

Examples:

https://maps.massgis.digital.mass.gov/MassMapper/MassMapper.html?locid=F_774471_2956366

or

https://maps.massgis.digital.mass.gov/MassMapper/MassMapper.html?bl=MassGIS%20Basemap__100&l=Basemaps_L3Parcels____ON__100&b=-70.2513885498047,42.0434606003212,-70.18959045410158,42.07143675906666&locid=F_774471_2956366

The value to use for the locid parameter can be found by clicking on a parcel in MassMapper. The table will show the LOC_ID attribute in the table.

Table of Contents

 

Downloading data using the export data layers tool

 

This tool is useful for downloading small areas of data layers in various formats for use in mapping software, or to simply get the tabular attribute data. If you need data layers for larger areas, we recommend downloading the statewide data layers.

1. Click the "Export data layers" tool.
2. The data export wizard will appear in a pop-up window. The data layers will be listed with the number of features that will be exported. If you have gone beyond the limit of features for any data layer, it will be indicated in the "OK to export" column. Click "Next" to continue.
   
   
3. The next pane will display several options for your data export:
   1) Choose the data format (the default is Shapefile).  New: AutoCAD version 14 .dxf or GeoPackage or GeoJSON. (Note: .dxf is geometry only, no attributes)
   2) Choose the coordinate system (the default is NAD83 MA Stateplane Meters, as this is how all MassGIS data are stored).  New: NAD83 MA Stateplane Feet
   3) Input a file name (note: spaces will be converted to underscores)
   4) Click Finish.
   

In the final pane, click on the Download box and the file will be placed in your Downloads folder.

Table of Contents

 

Saving a map as a PDF

 

Before saving a map, use the trash can icon to remove any default data layers or any you may have added that you do not need or have simply checked off. This will help to save space for the legend; especially if you have a long legend which may be saved as a second page of your PDF depending upon the length of the legend.

1. Click the "Print map" button.
2. A pop-up window will appear. Enter a title for the map that will appear at the top of your PDF.
3. If desired, change the default name of massmapper.pdf (be sure to retain the .pdf extension and use no spaces in file name!).
4. Choose the Page Size radio button you want.
5. Click the Print Map button. A PDF will be created and placed in your Downloads folder. You can cancel the PDF creation by clicking the "cancel" button.
   New: The PDF will have the date included in the lower left.
   
   

 
Table of Contents

 

Problems? Questions? Comments?

 

Please report problems and give feedback

If you notice any bugs in the application or think that something should be explained better in this help document, please Contact MassGIS.

Table of Contents

6/12/2025