Map

Use a Map widget to display locations on a map. Platforms such as iPhone (above 3.0) and Android provide a native map widget, that can be displayed as part of an application. The following table shows the available mapping services:

Platform Mapping Service
Android Google Maps
iPhone Google Maps
Mobile Web (advanced) Google Static Maps, Native maps of the device, and interactive maps (Java script)

On platforms where a native map widget is not available, the Map widget integrates with Google Maps to display a static image with zoom and pan controls. You can customize the map view.

To learn how to use this widget programmatically, refer Quantum Visualizer Widget guide.

Note:

Look Properties

Look properties define the appearance of the widget. The following are the major properties you can set:

For descriptions of the properties available on the Look tab of the Properties pane, see Look.

Map Properties

Map properties specify properties that are available on any platform supported by Quantum Visualizer, and assign platform-specific properties.

Note: In this section, the properties that can be forked are identified by an icon located to the left of the property. For more information, see Fork a Widget Property.

Callout Template

Specifies a template for a map callout (for example, a pin) that indicates a particular location on a map. The template can include Label, Link, RichText, Button, and Image widgets.

Note: If a template is not specified, the platform-specific default callout is used.

For information about creating a callout template, see Templates:Maps.

To specify a template, click Edit to open the Callout Templates dialog box, and then choose a template from the list of available templates.

Pin Image

Specifies the pin image to use to indicate a location on map. A default image is provide by the system.

To specify a pin image, click the Edit button to open the Pin Image dialog box. To change the default pin image, select Default and then select a pin image from the value list. To specify a platform-specific pin image, select the platform and then select a pin image from the list.

Mode

Specifies the map viewing mode. The mode can be one of the following:

Select a value from the Mode list to specify a default mode that is applied to all platforms. To provide a platform-specific mode, you can fork the Mode property. See Fork a Widget Property for more details.

Source

Specifies the map source. The map source can be one of the following:

Note: SPA platforms support only Google Static Maps as a source. Static maps are directly requested from Google for a given latitude and longitude. Quantum Visualizerdoes not support any other option because the size of the get request URL could be larger than 256 characters, causing the request to fail.

Select a value from the Map Source list to specify a default map source that is applied for all the platforms. To provide a platform-specific map source, you can fork the Map Source property. See Fork a Widget Property for more details.

Zoom Level

Specifies the zoom level for the current map view. The range varies from platform to platform.

Select a value from the zoom level slider to specify a default zoom level that is applied for all the platforms. To provide a platform-specific zoom level, you can fork the Zoom Level property. See Fork a Widget Property for more details.

Full Screen Widget

Specifies whether the Map widget occupies the full screen.

Note: This property is available only on VBox forms.

Callout Width

Specifies the width of the callout on the map. You can specify a value between 1 and 100 that represents a percentage relative to the width of the Map widget. For example, a callout width of 100 uses the full width of the widget. If the specified value is less than 1 or more than 100, the callout width is set to 80 percent.

Height

Specifies the height of the map as a percentage relative to the value of the Height Reference property.

Note: This property is not available on Flex Forms.

Height Reference

Specifies how the map height is calculated:

Note: This property is not available on Flex Forms.

Show Current Location

Specifies whether and how the current location on the map is indicated:

Note: This property is specific to the iOS platform.

Zoom Control

Specifies whether to display the zoom control on the map.

Note: This property is specific to the Android platform.

Actions

Actions define what happens when an event occurs. On a Camera widget, you can run an action when the following events occur:

For more information, see Add Actions.

Placement inside a Widget

The following table summarizes where a Map widget can be placed:

Flex Form Yes
VBox Form Yes
FlexContainer Yes
FlexScrollContainer Yes
HBox Yes
VBox Yes
ScrollBox Horizontal Orientation -Yes
Vertical Orientation- Yes
Tab Yes
Segment No
Popup Yes
Template

 

Header- No
Footer- No

Widget Appearance on Platforms

The appearance of the Map widget varies as follows:

Platform Appearance
Android
iOS
SPA

 

 

 

 

Rev Author Edits
8 SHS SHS
7.2.1 SHS SHS
Copyright © 2020 Temenos. All rights reserved.