Map Web Part

Overview

The Map web part provides a simple, Google Maps-based interface to display a single SharePoint list's content (which has latitude and longitude fields) with an interactive map.

Tutorials

Create a Data Source & View

1. Create your list/library, adding any columns and content necessary. For a map, you will need Latitude and Longitude columns of the Single Line of Text type. Although you can select more than one column to appear in the callout "bubble," it is suggested that a custom Calculated column be used to get fine-grain control over layout. This column will display as HTML
2. Create and title a new Standard View which contains, orders, and sorts all columns you wish to display in the map. Any edits made to this view will be immediately reflected in the map.
3. Update the View's Item Limit value to a number greater than or equal to the total amount of items in your view. For safe keeping, consider raising this item to a number much higher than your current item count. If you see your View paging, any items on subsequent pages will not appear in the map.
4. Save and make note of the View’s title.

Add the Web Part

1. While on a page, insert the Map web part using the 'Insert' menu in the Ribbon.
2. Open the web part’s properties, go to the 'Data Layers' tab
3. Click the 'Add New Layer' button
   
4. Select your list using the 'Browse' button under the 'List' field
5. Once the data source is selected, select the desired View.
6. Map the relevant columns to the fields:
   • Latitude
   • Longitude
   • Title
   • Description
   
   
7. The 'Custom Icon' field can be used to add a custom icon for the pin on the map
8. Click the 'Save Layer' button in the Data Layer form.
   • Important: Clicking 'OK' or 'Apply' from the bottom of the settings will not save the Data Layer
   
   
9. Click 'OK' to confirm your changes.

Editing the Layout

You can adjust the map's zoom level, center point, and height by opening the web part's properties and modifying the fields under the 'Map Options' tab.

If you do not see your map marks in their expected location, zoom out until you see them. If they appear near China, ensure that you have used a negative Longitude. If they do not appear at all, ensure that your Longitude and Latitude values were not switched in your data or your web part properties.

Known Limitations

• Limited to SharePoint as a data source
• Search
• Locate Me (not available on HTTP protocol)

Requirements

• Oregon Starter Template 4.6+
• JavaScript must be enabled
• Browser must meet the statewide minimum requirements
• All locations/items must be available in page 1 of your view

Accessibility

Until we build out the accompanying list functionality (slated for a later release), this web part has an aria attribute of aria-hidden="true" so that it is ignored by screen readers. Once we have add functionality to list locations, its visibility will be controlled by the web part properties; however, the map will continue to be marked aria-hidden="true" but the list will always be available for screen readers.

Features & Functionality

• SharePoint data source
• List/Library Views are supported
• Map & Satellite layers
• Street View
• Zoom controls
• Full Screen support
• Customizable Height
• Customizable Zoom Level
• Customizable Latitude/Longitude
• Multiple data source and views
• Custom Icons
• Legend

Default Values

• Starting Zoom Level: 6
• Container Height: 400 (px)
• Center Latitude: 43.9336
• Center Longitude: -120.5583

Frameworks/Libraries Dependencies

• jQuery
• Google Maps API v3
• Bootstrap 3.x

Still have questions?  

You can:

• Search the Knowledge Base for what you are looking for: 

• You can find more articles in the V4.x Article Index
• You can submit a question to the Oregon E-Government Service Desk