Maps Element Properties

General Settings

  • Datasource: Defines the data source for the locations to be displayed on the map. Sources like REST API and SQL Actions are supported.
  • Latitude: The latitude the map will focus on at initial load. Can be assigned statically (e.g., 38.4237) or dynamically.
  • Longitude: The longitude the map will focus on at initial load. Can be defined statically or dynamically.
  • Circle Radius In Km: Highlights a specific area on the map with a circular boundary defined by a radius in kilometers.
  • Auto Center: Determines how the map will be positioned when it opens.
    • True: The map automatically centers itself to cover all locations in the data source and determines the appropriate zoom level itself.
    • (It positions itself to include all markers.
    • False: The map does not perform any automatic centering. The opening position is set according to the values specified in the Latitude and Longitude fields. If these fields are empty, the map opens at the default starting position.
    • When Auto Center = True, the Latitude and Longitude values are not used.
  • Keep Center On Zoom: Keeps the map center fixed during zoom in/out operations.

Appearance & Icon Settings

  • Group Picker Icon: Groups nearby locations under a single cluster icon at low zoom levels.
  • Group Picker Color: Sets the background color of the grouped location icons.
  • Current Location Icon: Defines the icon that represents the user's current location.
  • Current Location Color: Allows setting the color of the current location icon.
  • Selected Location Icon: The icon used to display the location selected (clicked) by the user.
  • Marker Popup Width: Sets the width (in pixels) of the info popup that appears when a marker is clicked.

Map Type

  • Map Type: Specifies the general visual style of the map.
    • Roadmap: Standard road map.
    • Terrain: Topographic map showing elevation and land features.
    • Satellite: Displays real-world satellite imagery.
    • Hybrid: Combines satellite view with road and city labels.
  • HideTransitLayer: Controls whether public transportation routes (train, subway, tram, etc.) are displayed on the map. The default value is false.
  • HideTrafficLayer: Controls whether the traffic density layer (road occupancy status) is displayed on the map. The default value is false.

Latitude and Longitude values must be in Decimal format (e.g., 38.4237, 27.1428).

The map still loads and displays available locations even if the Latitude and Longitude values are null.

Location Retrieval Tip

To obtain latitude and longitude values from Google Maps:

  1. Right-click on the desired location on the map.
  2. Copy the coordinates from the context menu.
  3. Paste the values into the Latitude and Longitude fields of the Maps element.

Events

  • On Location Click: Triggered when the user clicks a location on the map.
  • On Map Load: Triggered when the map is fully loaded.
  • On Zoom Change: Triggered when the user zooms in or out on the map.