This type of widget belongs to the Dashboard category in the widget library. It enables you to geolocate, for a given measure, places (e.g. countries, cities or addresses) that are related to statistical data on a map using the online mapping service, Google Maps.

In execute mode, the display is made up of two panes:

• The map (1) in which map markers are placed (1):
  • Infotips appear when you move the mouse over each location marked on the map.
  • The position of the logged-in user is indicated by a blue marker (2).
• The Transit pane (optional) (2) indicating the travel time for the selected means of transportation between the current user position and one of the locations marked on the map.

Notes

     See General remarks on widgets

• The data source must contain one or more Dimension columns that identify the locations and one Measure: Observed value column.
• The properties you must specify depend on the way locations are defined in the data source:
  • Using the highest-level location. You should specify the Content > Address property.
  • Using different address fields in  when the data source points to a view linked to the AM_LOCATION table. You should specify the Content > Address property and select the Full Address (<Nom_table>) virtual field.
  • Using latitude and longitude coordinates. You should specify the Content > Latitude and Content > Longitude properties.
  • Using the postal address. You should specify the Content > Address property.
• When transit information is displayed, the web browser may request authorization to retrieve the current user position.
  • We recommend that you keep it enabled on a permanent basis for the  website.
  • Subsequently, you can modify this access permission.  See the procedure depending on your web browser.
• In execute mode, you may need to zoom in to display traffic information and public transportation routes. If n/a is displayed, this means that the information cannot be calculated.

Best practices

• You should use the Google Maps widget to display values on a map.
• Use a simple map style that highlights values (Visualization > Style Editor).
• Create a custom widget if you want to keep the map style and reuse it in other widgets.

Example

You want to display the number of incidents (measure) for each subsidiary in North America (dimension elements) on a map. The data source below includes different ways in which you can define locations (highest-level locations, specified addresses, latitude/longitude).

        See the procedure to find out how to specify properties depending on the structure of your data source.

Data source	Google Maps widget
Download Example (CSV file)

List of properties

Content

DataSource

DataTransformer

Latitude: Data source column where the latitude coordinates are stored.

Longitude: Data source column where the longitude coordinates are stored.

Address: Data source column where the highest-level locations or specified addresses (e.g. countries, cities) are stored. Note:  When the data source points to a view linked to the AM_LOCATION table, you can use the Full Address (<Table_name>) virtual field.  See General remarks on widgets

Value: Data source column where the measure values are stored.

Tooltip Label: Data source column where the location names are stored. Note: These names are displayed in infotips on the map.

Data

MaximumNumberOfDisplayedData

Visualization

Style Editor: XML code describing the map style. Enter the code directly in the field or click  to display the list of styles available. Note: To avoid errors when inserting a map style, you should copy and paste the XML code available on the website.

      Consult the following website: snazzymaps

User Position: When the app allows access to traffic information, this determines if the current position of the logged-in user should be displayed as  on the map (box is checked) or not (box is not checked).

Show Travel Time (Note: Only if the User Position box is checked): Used to indicate if the Transit pane should be displayed (box is checked) or not (box is not checked).
         

Public Transportation: Used to indicate if public transportation routes should be displayed (box is checked) or not (box is not checked). In execute mode:

• Users can choose to display or hide this information using the  icon.
• Click  to display and select the means of transportation required.
                

Traffic: Used to indicate if traffic information should be displayed (box is checked) or not (box is not checked). In execute mode:

• Users can choose to display or hide this information using the  icon.
• Click  to display and select the means of transportation required.
            

Auto Fit Marker: Used to indicate if the default zoom level applied to the map in execute mode should automatically be adjusted to display all markers on the map (box is checked) or not (box is not checked). If you do not want the map to be adjusted automatically, then you should specify the default zoom level using the Zoom Level tool.

Zoom Level (Note: Only if the Auto Fit Marker box is not checked): Tool used to manually define the zoom level to be applied to the map in execute mode.

Visualization Type: Type of markers placed on the map.

• Image: Depends on the selected map marker template (Image > Select Map Marker property).
• Circle: Circle whose size is proportionate to the value represented.
  • Use the Circle > Maps Thresholds property to define different colors corresponding to different thresholds.
  • When too much data is displayed in close proximity, it will be grouped together in a marker (1). You must then zoom in to view individual values (2). Note: Google Maps manages geographical proximity and decides if there is sufficient space for displaying several circles or if a single big circle should be displayed instead.
             
• PinCircle: Marker in which a value is displayed. Note: Use the Circle > Maps Thresholds property to define different colors corresponding to different thresholds.

Image	Circle	PinCircle

Image

Note: These properties are available only if the marker is an Image.

Select Map Marker: You can select the template for the map marker in the icon gallery provided by .

Circle

Note: These properties are available only if the marker is a Circle or PinCircle.

Maps Thresholds: Used to define different colors for markers corresponding to different thresholds.
         

• Enter each value marking a change of color.
• Click on each map marker then select the desired color via the Color Picker.

Color Opacity (0.1 - 1.5): Tool used to define the transparency of the map marker.

Text Police Size (10 - 15): Tool used to define the font size for values displayed within markers.

Theme

  See List of properties

Procedures

How to specify properties for locations

• The properties below must be specified when locations are defined using the highest-level locations:
  • Address: Location
  • Value = Nbr of Incidents

• The properties below must be specified when locations are defined using latitude/longitude coordinates:
  • Latitude: Latitude
  • Longitude: Longitude
  • Value = Nbr of Incidents

• The properties below must be specified when locations are defined using postal addresses:
  • Address: Address
  • Value = Nbr of Incidents

How to modify the geolocation permission granted to the ev Service Apps website

In Firefox

1. Go to the  website.

2. Select Tools > Page Info in the menu and open the Permissions tab.

3. Change the Access your location setting.

In Chrome

1. In the web browser toolbar, select the Chrome menu .

2. Select the Settings tab and click Show advanced settings.

3. In the Privacy section, select Content settings. In the Location section, select the default authorization desired for future geolocation requests and click [ OK ].

Note: Select Manage exceptions to delete previous authorizations granted to certain sites.

In Internet Explorer

1. In the web browser toolbar, click  and select Internet options.

2. Select the Security tab.

3. In the Security settings section, select Trusted sites and click the [ SITES ] button.

4. Define the required authorizations:

• To add an authorization, enter the URL of the website and click [ ADD ].
• To delete an authorization, select the URL of the website and click [ DELETE ].