Setting map options

There are a lot of settings that affect how the map is displayed. To access the full collection of settings for the map:

Click the button (not on the arrow) to bring up the map properties window

 

The following options can be configured:

 

Auto Best Fit

When turned on, the map zoom level and center will be calculated and set to best fit the items plotted on the map when new results become available. When turned off, the map center and zoom level will only be adjusted by manual panning and zooming. At any time, you can manually perform a best fit of the results.

Cluster adjacent items

When clustering is turned on, map items that are located close to each other will be plotted on the map as a single item.

 

Clustering on

Clustering off

 

When items are clustered, the number within the cluster icon represents the number of clustered items. You can click on the cluster to zoom in on the items contained within the cluster.

Turning clustering on will improve speed when a large number of items need to be plotted on the map.

Note: when a map is printed or exported, clustering will not be used

Clustering max zoom level

This setting specifies the maximum zoom level at which clustering will be applied. When the map is zoomed in deeper than this level, clustering will not be applied. This value is useful when objects are very close together (e.g. neighbors). In these cases, if this setting didn't exist, these items would always be drawn as clustered.

Clustering size

The size of the clustering algorithm's grid. The value represents the cell size, in pixels, of the grid. If two map items are in the same cell, they will be clustered. The lower the value, the less items that will be clustered together. A higher value will produce more clustering.

Lowest level only

When turned on, only members on the lowest available level in the results will be plotted on the map. When turned off, all members will be plotted.

In the example below, we have the countries on the rows and drill down on Germany. When lowest level only is off, all provinces in Germany are plotted as well as Germany itself and other countries, when turned on, only the provinces are plotted.

 

Data in grid

Lowest level only is off

Lowest level only is on

Show scale

When turned on, shows the scale of the current map in the lower left-hand corner.

Show overview map

When turned on, an overview map is displayed in the lower right hand corner that provides an overview of the current view from a larger perspective.

 

Chart background color

Sets the background color for charts. By default, the chart background is transparent so that the chart blends in nicely with the background. You can choose to apply a background color to the chart (optionally combined with a setting the transparency level) to improve legibility.

 

Chart background color combined with transparency

Chart size range

When the chart size is based on a tuple (column or row), the size of the chart will fall within a certain range, based on the tuple value. The range is specified in this setting by supplying the maximum and minimum values for the range.

Note: if the chart size is not dependent on a tuple, the size used will always be the median value in the range.

Chart transparency level

Charts can be configured to be partially transparent by setting this value. The value is a number between 0 (= fully transparent) and 255 (= fully opaque). Making charts transparent makes it easier to read items covered by charts.

 

Show pin shadow

Determines whether a shadow is displayed behind pins.

 

Pin shadows are on

Pin shadows are off

 

When a large amount of pins are drawn, it can improve speed and legibility to turn off the pin shadows.

Pin size range

When the pin size is based on a tuple (column or row), the size of the pin will fall within a certain range, based on the tuple value. The range is specified in this setting by supplying the maximum and minimum values for the range.

Note: if the pin size is not dependent on a tuple, the size used will always be the median value in the range.

Pin start/middle/end color

When the pin color is based on a tuple (column or row), the color of the pin will fall within a certain range, based on the tuple value. The color range is specified by configuring values for the Pin start color, Pin middle color and Pin end color. The member with the lowest value will be displayed using the Pin start color, the highest value will be displayed using the Pin end color. All other members will have their color calculated as a mix of the start/middle or middle/end colors, based on the their value.

Note: if the pin color is not dependent on a tuple, the color used will always be the color defined in pin start color.

Pin transparency level

Pins can be configured to be partially transparent by setting this value. The value is a number between 0 (= fully transparent) and 255 (= fully opaque). Making pins transparent makes it easier to read items covered by pins.

 

Transparency level is set to 150

 

Note: transparency is not supported for custom pin images

Custom pin image

By default, pin images are in the shape of a marker. However, any image can be used as the pin image by specifying a value for this setting.
This value must refer to an http url, references to local file images are not supported.

In the following example, we used http://maps.google.com/mapfiles/kml/pal3/icon23.png as the custom pin image:

 

 

Placeholders

Placeholders can be added to the url that will be replaced with actual values when the image for a member is to be retrieved.

The following placeholders are available:

 

$$name$$

Will be replaced with the name of the member

$$color$$

Will be replaced with the calculated color for the pin (see pin color)

$$width$$

Will be replaced with the calculated height for the pin (see pin size range)

$$height$$

Will be replaced with the calculated width for the pin (see pin size range)

$$prop_<propertyname>$$

Will be replaced with the value of the property with name <propertyname> for the member. For example, if the member has a property gender, you would specify $$prop_gender$$ and this would then be replaced with the value of the member's gender property.

 

In the following example, we used http://www.google.com/chart?chst=d_map_spin&chld=1.5|30|$$color$$|10|_|$$name$$,$$prop_country$$ as value for this setting:

 

Custom pin size

When you have defined a custom pin image, the size will by default be determined by the Pin size range value. This will always assume that the image is square and is scales well to different sizes. With most images this is not the case. In these cases you can specify a value for this setting, this will then override the size range value and always be used as the size for the custom pin image.

Note: when the custom size is 0;0, this value is not used.