Using Multiple Markers

Using Multiple Markers

Return to Configuration Overview

Often the data that you want to map may fall into several categories and you want the marker for each location to represent the category. This is supported with the Virtual Map View Web Part.

baseball field list cropped.pngAs an example for these instructions, consider a SharePoint list that stores information about baseball fields in the USA.

You want to display National League parks with one marker type (Nmarker.png) and American League parks with another (Amarker.png).

Follow these steps to configure your map with multiple markers:

Step Action
1.

use multiple markers.pngIn the tool pane of the Virtual Map View, check the Use Multiple Markers box to use multiple marker types to denote different types of data (i.e., one marker for American League baseball parks and another marker for National League parks).

A selection list will appear next to the Use Multiple Markers box; it contains all the columns from the selected Data Source. Select the column from the data source that stores the value to determine the marker type to use.

In our example using the Baseball Fields list, this column is League.

2.

Next, you need to specify which marker to user for each value of the Use Multiple Markers column selected in Step 1 above. If you want to use custom markers, create them first.

NOTE: It doesn’t matter which Marker Type you select when planning to use multiple markers.

icon editor page.pngClick the Edit button next to the Marker Type field. An edit window appears.

For each Marker that you want to display on the map, edit the associated tag to update the MarkerType value. MarkerType should equal the value of the Use Multiple Markers column that is associated with that marker.

In our Baseball Fields example, the Use Multiple Markers column is League. The League column is set to either American League or National League for each baseball park in the list. For this baseball field example, we created two custom markers, one called NL for National League and the other called AL, for American League. After updating the MarkerType value for each, the tags for those two markers look like this:

 <AL IconName = "Amarker.png" IconWidth = "45" IconHeight = "45" MarkerType = "American League" />
 <NL IconName = "Nmarker.png" IconWidth = "45" IconHeight = "45" MarkerType = "National League" />

When edits are complete, click Save to save changes and close the edit window. Otherwise, click Cancel to close the window without saving any changes.

3. After clicking Apply and then OK in the tool pane, a portion of the configured map will look like this:
baseball final example.png

Return to Configuration Overview

Using Marker Tabs

Using Marker Tabs

Return to Configuration Overview

popup tab display1.pngThe Marker Tabs appear when a marker on the map is clicked. An example with two tabs (General and Stats) configured is shown here.

NOTE: The Bing MapTM display shows the pages of the popup slightly different than the Google MapTM display. The one shown here is the Bing MapTM display.

Other popup1.pngAnother pop-up display, called Item Description, appears when the end user hovers over the list of items on the left side of the Virtual Map View display. An example is shown here.

To configure both displays, follow these steps:

Step Action
1.

tab titles1.pngIn the Virtual Map View tool pane, decide how many tabs you want to use. Enter a Title for each.

NOTE: If you don’t want to use a tab, leave the Title blank.

In the example shown here, we use two tabs and label them General and Stats.

2.

example with two tabs with num.pngNext, decide what column values from the list to display on each tab.

  1. Select a column from the Available Columns list that you want on the first tab. All columns from the list should be displayed.
  2. Click on the arrow > button to move the column from the Available Columns list (left box) into the Display Columns list (right box) and it will be positioned under the first tab.
  3. For subsequent tabs, highlight a tab label in the Display Columns list on the right side before selecting an available column and moving it to the right. It will be positioned beneath the highlighted tab.

To remove a column from the Display Columns list, select the column from the list, and click the left arrow button. The column you highlighted will be removed from that list.

To move the columns up or down once they appear in the Display Columns list, highlight the column in the Display Columns list and click the up (up arrow.png) or down (down arrow.png) arrow. The highlighted column will move one position.

NOTE: You cannot move a column from one tab to another; you can only shift positions of columns within the tab group. To move a column to another tab, remove it from a tab group and follow the procedure above to move it into the appropriate tab group.

3.

column alias1.pngRename a displayed column. Sometimes the actual column name may be too long or not descriptive. Rather than displaying the actual name of the column, it is possible to use a column alias for display in the marker tab on the map.

To create an alias, double-click on the column name in the Display Columns list. An Edit Column Name section appears below the web part highlighted in bright pink. Type the new name in the Rename to field. click Save to save your change. After saving the column name, you will see it change in the Display Columns window.

NOTE: The column is not renamed in the source list. This change is only an alias used on the map display.

4.

Other popup1.pngThe order of the tabs and columns configured for the Marker Tabs in Step 3 impacts the order that columns appear in the Item Description pop-up shown here. The tab Titles don’t appear here, but the columns do.

NOTE: If the column appears in the Marker Tab, it also appears in the Item Description pop-up. If you created a column alias, it will appear in both pop-ups.

Return to Configuration Overview

The Page Navigation doesn’t appear when displaying map data in SP2013

The Page Navigation doesn’t appear when displaying map data in SP2013

Issue:

navigation issue.pngYou are displaying data in Virtual Map View v10.9.42.2013 using the Bing map provider. You have configured the map to display locations in groups of 15.

no page nav.pngWhen you view the map, you see the first 15 locations, but you don’t see any way to go to the next page of locations. Page navigation should appear next to the Navigation drop down in the lower left corner of the page.

Resolution.

address column not configured.pngAlthough the locations are displayed, the Page Navigation will not be displayed if a column hasn’t been configured for each of the geocoding parameters. For example, the screen shot here shows no column selected for Address. When this is the case, no Page Navigation will be displayed.

To display the Page Navigation, be sure a column is configured for Address, City, State/Province, and Country/Region.

NOTE: The columns configured for each geocoding parameter do NOT need to contain data. The column values may be blank.

Some of the markers appear in the wrong location on the map

Some of the markers appear in the wrong location on the map

Issue:

You are plotting locations based on Address information and one of the markers appears in the wrong place.

See the example below where we are using BingTM Maps to display baseball fields in the USA. The marker for the Seattle Mariners appears in Africa, but the City and State values are Seattle and WA respectively. Why doesn’t it show up in Washington state in the USA?

NOTE: Depending on the data you are trying to display, this may occur when using GoogleTM maps as well.

bing map showing outlyer.png

Resolution:

There are a few things you can try when you see an issue like this with the Virtual Map View:

  1. One thing to note about this map display scenario is that we are passing City and State without additional information such as Address (street) or Country to the Map Provider. As you can see, this works for most of the markers.

    tool2with stamp.pngIf we add Country and don’t change the map provider, the Seattle Mariners will appear where they should. In other words, in this scenario the BingTM mapping service needed a little more information in order to locate Safeco Field properly.

Icon-WarningIMPORTANT: Unless all the geocoding parameters are mapped, only 20 locations will be mapped if using the BingTMmap provider. The GoogleTM map provider doesn’t have this limitation in SP2013. All locations will be plotted on the Google map with partial geocoding parameters.

NOTE: If you are using SP2010 with either the BingTM or GoogleTM map provider, ALL geocoding parameters are required in order for any data to be displayed.

  1. The available Map Providers (i.e., GoogleTM and BingTM) use different geocoding algorithms and sometimes one works better than the other for particular datasets. For example, with the same original dataset (that does NOT include Country), the GoogleTM map provider puts the Seattle Mariners Safeco Field in the right location:

no outlyer with google.png

  1. If you have latitude and longitude information for your locations, the map providers can plot those rather than try to geocode the address information you provide. This will probably result in the most accurate display, regardless of the Map Provider. It will also result in the quickest display since the mapping provider doesn’t need to geocode first; this saves processing time.

    Icon-WarningIMPORTANT: If you configure the web part with a column value for Latitude and Longitude, only the items with values in those columns will be plotted on the map – even if you have also configured your web part with address information. It is not currently possible to have some markers plotted using the address information and some with the Latitude and Longitude.

Select a column to display

Select a column to display

Return to Configuration Overview

Follow these steps to configure the left side display of the Virtual Map View:

Step Action Result
1. Select a column to display in map. Select a column name from the drop-down list to be displayed in the Map View under the Select View option.

tool6a.png

The column you select here shows up on the interface here.
column to display.png
2.

Records per page. You can specify the number of records to be displayed on the map. The additional records can be viewed by the Next and Previous buttons at display time. If this value is left blank, the web part default is to display 20 records at a time.

tool6b.png

Icon-Tip Displaying icons in pages may speed you page load times since only the items in the first page are loaded initially.

If your list has more records than your limit, the web part displays numbers next to the navigation drop-down menu to help navigate to more records.

Icon-Tip To display all the icons, regardless fot he Records per Page, select View All from the selection list at the bottom of the list.
view all.png

Return to Configuration Overview

Release Notes for Virtual Map View

Release Notes for Virtual Map View

NOTE: Release Notes will open in a new browser tab

WSSv3/MOSS SharePoint 2010 SharePoint 2013 SharePoint 2016
Release Notes Release Notes Release Notes Release Notes
Microsoft ended mainstream support for SharePoint 2007 in October 2012. See Microsoft’s Lifecycle Support Policy.
At that time, Bamboo stopped enhancements to our SharePoint 2007 product line, but continues to provide support and bug fixes to customers with active support contracts until October 2017. Previously purchased licenses will continue to function after October 2017, but support for these products will end, and no additional bug fixes will be provided beyond that time. Bamboo plans to cease selling new licenses and annual support contacts for its SharePoint 2007 products in October 2016 to ensure customers will be eligible to receive support for at least one year after purchase.
Microsoft plans to end mainstream support for SharePoint 2010 in October 2015. See Microsoft’s Lifecycle Support Policy. At that time, we will stop any enhancements for our SharePoint 2010 product line but will continue to provide support and bug fixes for our SharePoint 2010 products to customers with active support contracts until October 2020. Previously purchased licenses will continue to function after October 2020, but support for these products will end, and no additional bug fixes will be provided beyond that time. Bamboo plans to cease selling new licenses and annual support contacts for its SharePoint 2010 products in October 2019 to ensure customers will be eligible to receive support for at least one year after purchase.

Visit our website where you can get the latest info about each of our products for SharePoint 2013.

A separate installation package and license key is required for SharePoint 2013 deployment. For additional details, review the following knowledge base articles:

Bamboo Solutions has also begun releasing products for SharePoint 2016. For additional details, check the product release notes in the link above, or contact us.

For details on migration, see the Knowledge Base Article “Migrate Bamboo Products from SharePoint 2013 to SharePoint 2016”

Understanding Bamboo Releases:

  • Bamboo offers Trial, Basic and Premium support.
    • Free Trial support expires after 30 days.
    • For more information about Basic and Premium support, please see the Support Plans page.
    • There may be a fee to upgrade from a major version to another.

See Also:

Overview of Virtual Map View Web Part

Overview of Virtual Map View Web Part

An example of the Virtual Map View displaying the location for each Major League Baseball park in the USA is shown below. Use the numbers shown to learn more about the display features of the web part.

SP2010 end user view with numbers.png

Description
1.

Select View.pngSelect View. This is an optional display feature. You may not see it if it wasn’t configured in the instance of the map you are using.

It allows you to select different views of the data to be displayed. Typically, the various views are ones that filter the data different ways.

For example, in our baseball field example, we have a view that includes only the parks from the National League teams and another view that includes only the parks from the American League. Another view is one that includes all the parks, but is sorted by State. The first view on the list (which is the default view) is a view called All Items)) that includes all of the parks, regardless of the League. It is sorted by ID.

Icon-Tip Because the map is automatically zoomed to show just the best view of the displayed locations, selecting a view of just the locations in a certain area provides a convenient way to zoom into that area of the map.

In addition to the filter in a view, the sort order is also used for the Virtual Map View display. Choosing a different view may change the sort order of the items displayed in the list on the left side of the display. for example, choosing the sort by State view in our example will display the list of parks sorted by State, even though State is not displayed in the list.

2.

Sort Bar. Clicking the arrow on the sort bar will sort the list of items displayed. Clicking it a second time will reverse the sort order.

NOTE: If your list spans multiple pages, the sort impacts just the items on the current page.

3.

List of Displayed Locations. The list on the right side includes all the locations that appear on the map, at the particular time. The locations will change if your locations are displayed in pages (see #5 below).

left side popup1.pngHover your cursor over a list item and a popup appears listing additional information about the location. The information displayed on this popup is configurable, so if you don’t see something you expect to see, talk to the person who configured the map.

click on location.pngIf you click on a list item, that location will be centered on the map and another popup, if configured, will appear next to the marker. This popup is also configured and can show data in up to three different tabs.

The example shown here has just two tabs: General and Stats. Notice how the order of the displayed information is the same as the list item popup; its just spread across the two tabs.

4.

Navigation and pages.pngNavigation selection. The Navigation selection will always appear regardless of whether the map is configured to show locations in multiple pages. The options available in the selection are:

  • Navigation. This is the default. When the map is configured to display locations in distinct pages, the page numbers will be displayed next to this selection.
  • View All. If you are displaying a single page of locations, selecting All Items will display all locations from all pages at once. In other words, it overrides the page configuration temporarily.

    NOTE: When View All is selected, the page navigation (see item #5) will be hidden. To return to page viewing, select Navigation.

5.

Navigation and pages.pngPage Navigation. Click the page number to display locations from that page.

Icon-Tip Because the map is automatically zoomed to show the best view of the displayed locations, selecting a different page will refresh the map and may zoom into another area of the map since each page includes different locations.

6.

Map Provider Tools. Use the standard map user interface to zoom, pan and select the type of background on the map (i.e., simple streets, roads with terrain, aerial views, satellite).

Icon-WarningIMPORTANT: The available tools will depend on the Map Provider used. Available options are GoogleTM or BingTM.

7.

click on location.pngMap Markers. Click a map marker and that location will be centered on the map and the marker pop-up, if configured, will appear next to the marker. This pop-up is configured in the web part tool pane and can show data in up to three different tabs. If you don’t see the data you need, talk with the person responsible for configuring the map.

To close the pop-up, in BingTM just move the cursor to a different location on the map. To close it on a GoogleTM map, click the X in the upper right corner of the pop-up or click another marker.

Icon-Tip With the BingTM maps, hovering over the marker will cause the pop-up to appear. No need to click. However, if you want to center the marker on the map, click the marker.

NOTE: Clicking the marker on a GoogleTM map doesn’t center the location. It may shift the map so the popup can be displayed.

Overview of Virtual Map Configuration

Overview of Virtual Map Configuration

shadow HW31 toolpane with 8 numbers.png Configuring Virtual Map View offers a variety of options from the type of data source to the type of maps and markers to display.

Each of the sections within the configuration tool pane window is divided for ease of use when configuring the web part.

  1. Data Source for Virtual Map View
  2. Geocoding
  3. Select the Map Provider and choose a marker type
  4. Use Multiple or Custom Markers
  5. Using Marker Tabs
  6. Select a column to display and the number of items per page
  7. Language
  8. CSS for Virtual Map View

Only the first 20 locations are plotted on the map

Only the first 20 locations are plotted on the map

Issue

loading 6 of 20.pngYou have 30 locations to plot on the map. When the page loads, you see the message in the lower left corner of the map showing the progress of the data load. It loads pretty fast, but stops when it gets to 20. The last 10 locations don’t load.

You are displaying locations in SP2013 v10.9.42.2013 and using the BingTM Map Provider.

Resolution

address column not configured.pngAlthough some locations are displayed, no more than 20 will be displayed if a column hasn’t been configured for each of the geocoding parameters. For example, the screen shot here shows no column selected for Address. When this is the case, only the first 20 locations will be displayed.

To display all the locations, be sure a column is configured for Address, City, State/Province, and Country/Region.

NOTE: The columns configured for each geocoding parameter do NOT need to contain data. The column values may be blank.

Icon-Tip This is not a requirement if using the GoogleTM map provider in SP2013.

Migrating Virtual Map View from SharePoint 2007 to SharePoint 2010

Migrating Virtual Map View from SharePoint 2007 to SharePoint 2010

Be sure you have at least the Minimum SharePoint 2007 Product Release (shown in the table below) installed before migrating. If not, upgrade your Bamboo product release before migrating. For more information, see Upgrading your Bamboo Web Part. Also, the target SharePoint 2010 farm requires at least the Minimum SharePoint 2010 product release shown.

Icon-Warning IMPORTANT: When migrating from SharePoint 2007 to SharePoint 2010, you MUST select the option to change existing SharePoint sites to use the new user experience. Your Bamboo products will not perform as expected with the old look and feel.

Minimum SharePoint 2007 Product Release 1.9.25 Minimum SharePoint 2010 Product Release 10.9.9
In-Place Upgrade
Issues The Virtual Map View Web Part migrates without any errors or additional steps required.
Resolution N/A
Database Attach Upgrade Method
Issues If Virtual Map View Web Part is configured to use Google Maps, users will receive the following error:

Please re-config your URL in Google Settings. The valid URL 
is directory or domain.
Resolution To resolve this issue, the Internal URL and Google Key must be updated in the Web Part Tool Pane.

Migrating Virtual Map View from SharePoint 2010 to SharePoint 2013

Migrating Virtual Map View from SharePoint 2010 to SharePoint 2013

Be sure you have at least the Minimum SharePoint 2010 Product Release (shown in the table below) installed before migrating. If not, upgrade your Bamboo product release before migrating. For more information, see Upgrading your Bamboo Web Part. Also, the target SharePoint 2013 farm requires at least the Minimum SharePoint 2013 product release shown.

Icon-WarningIMPORTANT: When migrating from SharePoint 2010 to SharePoint 2013, the Database Attach Upgrade Method is the only method supported.

Minimum SharePoint 2010 Product Release 10.9.46 Minimum SharePoint 2013 Product Release 10.9.41.2013
Database Attach Upgrade Method
Issues The Virtual Map View migrates without any errors or additional steps required.
Resolution N/A

Select the Map Provider and Marker Type

Select the Map Provider and Marker Type

Return to Configuration Overview

Select Google MapsTM or Bing MapsTM web services option to display your data source. Depending on the selected web services, you can choose a default view from the available options listed in the Default map view drop-down (such as road map, satellite imagery, or street map with terrain for Google Maps).

NOTE: Select Virtual Earth (the earlier name of Microsoft’s mapping platform) to use Bing MapsTM.

Once you have selected a provider, use the table below to configure the available parameters specific to the provider.

Google MapsTM Bing MapsTM
Default Views Select the view to display as a default when users arrive at the page. Once on the page, users can choose other views. default views for google.png
Street Map example:google map view without terrain1.png
Satellite Imagery example:google sat view with labels1.png
Street Map with Terrain example:google map view with terrain1.png
default views for bing.png
Road View example:bing road view1.png
Aerial View example:bing arial view1.png
Display Options Choose the marker type for the displayed locations.

MarkerType.jpg

  • Default default marker.png
  • House house marker.png
  • Plus plus marker.png
  • Point point marker.png
  • Sun sun marker.png
  • Red red marker.png
  • Blue blue marker.png
  • Yellow yellow marker.png

Icon-Tip If none of these markers suit your situation, you can create your own marker. See Create your own marker for more information.

To show you the differences, we have included a few sample views below:

DefaultDefault.jpg
This is the default marker on a street map.
House Marker
House.jpg
Notice when selecting the street map with terrain, you see buildings and trees within the view.
Top
Point marker on street maps
VE-Point.jpg
This view uses a Point symbol on a street map; this map is a Virtual Earth map or Bing map. Below is a Google map using the Point marker as well. GooglePoint.jpg
Point Marker on Satellite Views
PointOnAerial.jpg
Using the Point marker on a satellite view may not be bad, but consider your end users zooming in on this map. Point.jpg
A Point marker may not work best for a close-up view with buildings; it blends in and becomes less visible.
Top
Sun Marker
Sun.jpg
A Sun marker on a street map may be a good marker to use.
Red Marker on Satellite View
Red.jpg
Choosing satellite terrain, does not give as much detail in the view.
Top
Blue Marker
Blue.jpg
A Blue marker helps pinpoint a location on a street view.
Yellow Marker on Street View
Yellow.jpg
This view uses a Yellow indicator on a street view that is very close up. These are the choices made on the tool pane to get this view:
Choices.jpg
Top

Return to Configuration Overview

I can’t get any data to display in the map

I can’t get any data to display in the map

Issue

You configured the Virtual Map View as the instructions describe, but you don’t see any data. You are using SharePoint 2010, release 10.9.53. You’ve tried both BingTM and Google TM map providers; you have the same issue with both.

n0 data in SP2010.png

Resolution

address parameter1.pngUnless you are using Longitude and Latitude, the SharePoint 2010 version of the Virtual Map View (release 10.9.53), requires that a column be mapped to each geocoding parameter (i.e., Address, City, State, and Country) in the tool pane. If you leave one un-mapped, no data will display.

Icon-WarningIMPORTANT: You don’t need to have values for each of the mapped columns, but the column mapping needs to be configured in the Virtual Map View tool pane. For example, often the Map Provider used will be able to geocode a location without the street or country information.

NOTE: This is not necessarily an issue with SP2013. Locations will be mapped if just City and State are configured. However, page navigation in SP2013 will not be displayed if some geocoding parameters are not mapped. Also, if using BingTM maps in SP2013, only the first 20 locations will be mapped unless all the geocoding parameters are mapped.