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.

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

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, and choose a data source via the Browse button and the Asset Picker menu.
3. Once the data source is selected, select the View you require.
4. Note that the default values are editable, in case you would like the map to be a certain height, initially center to a certain location, or initially zoom to a certain level.
5. Choose OK.

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)

Frameworks/Libraries Dependencies

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

Screenshots

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