Map

This widget is available only in Operations Hub Classic version.

A map widget is used to display a map in an application. It uses the Google Maps feature. You can use the map widget to display the location of a place on a map (for example, the location of each site of a company).

Note: You need external Internet access to use the map widget.

To display asset locations on the map, you must access the API key generated by Google.

Map Properties

When you use a map widget, in addition to providing values for the default fields for a widget, you must define the following settings.
Field Name Description
Label Identifies the title of the map.
Display Identifies the type of the map. You can select one of the following values:
  • Roadmap: Displays the streets of an area. By default, this value is selected.
  • Satellite: Displays a satellite view of the Earth.
  • Terrain: Displays the geographical features of an area.
Layers Identifies the layer that you want to display on the map. You can select one of the following values:
  • Transit: Displays the public transit network of an area.
  • Traffic: Displays real-time traffic information on the map.
  • Bicycling: Displays the bicycling paths of an area.
  • None: Does not display any layer.
CENTER Identifies the center point of the map. You can specify the center point using one of the following sources:
  • Data: Select a query output or a global parameter whose value is the center point of the map.
  • Manual: Enter the address or the latitude and longitude details of the center point manually, separated by a comma (for example, 35.681168, 139.767059).
  • User Location: Select this option to specify that the location of the device used by the application user is the center point of the map. If you select this option, the Update Center check box appears. If you select this check box, the map center is automatically updated when the user moves.
    Note: If you select the User Location option, when you access the map for the first time in the application, a message appears, asking you to allow the application to access your location.
  • Automatic by Markers: Select this option to specify that the center point of the map is positioned such that all the markers are visible on the map. This option is enabled only after you add a marker.
    Note: The Zoom box contains a value that determines the zoom level of the map. This box is disabled when you select the Automatic by Markers option.
MARKERS Identifies the markers that should appear on the map. Select Add Marker, and then enter or select values in the following sections or boxes that appear. See Markers table.
SHAPES Identifies the circle that covers the area of a location. For example, if the map displays the locations of sensors that capture the radio signals within a radius of 1 km, you can add a shape to each marker to indicate the area covered by each sensor.

Select Add Shape, and then enter or select values in the following sections or boxes that appear. See Shapes table.
Markers:
Field Name Description
Position Select one of the following options:
  • Data: Select this option if you want to specify the position of the marker by means of a query or a global parameter.
  • Manual: Select this option if you want to specify the position of the marker manually, and then enter the address or the latitude and longitude details.
Label Select one of the following options:
  • Data: Select this option if you want to specify the label of the marker by means of a query or a global parameter. This option is enabled only if you select Data in the Position section.
  • Manual: Select this option if you want to specify the label of the marker manually, and then enter the label.
Marker Icon Select the icon and color of the marker.
Condition Select Add conditions, and then specify the conditions for displaying the marker.
Tip: You can add multiple markers. For example, if you want one marker to represent sites whose overall plant efficiency is above 95 percent and another marker to represent sites below 95 percent, you can add the two markers with the same position data, and specify the conditions appropriately on each one.
Actions Select Add Action, and then specify the action that should be triggered when the marker is selected (for example, display more details about the location).
Shapes:
Field Name Description
Position Select one of the following options:
  • Data: Select this option if you want to specify the position of the shape by means of a query or a global parameter.
  • Manual: Select this option if you want to specify the position of the shape manually, and then enter the address or the latitude and longitude details.
Radius Select one of the following options:
  • Data: Select this option if you want to specify the radius of the shape by means of a query or a global parameter.
  • Manual: Select this option if you want to specify the radius of the shape manually, and then enter the radius in km.
Note: The radius can also be used as a visual indicator of other parameters, such as signal strength.
Color Select the color of the shape. You can also specify the opacity.
Condition Select Add conditions, and then specify the conditions. For example, if you want the marker to represent the signal strength received by a sensor, you can add multiple shapes with different colors and the same position data, and then specify different signal strength conditions on each shape.