Edit documentation Edit document
GH-Elements

Google Map

Google Map is a gh-element that allows to display the map where you can add the item markers.

Functional Characteristics

This element allows you to mark the location of apartments, places you want to visit or even food warehouses. In general, it is used instead of a table to display places by adding information about them to the map.

Value Format

This element does not have any field value.

Element Options

The google map has six groups of settings. Each of them configures different parts of element.

Field and Map Settings

The first group is the standard field settings. It does not have any additional options.

The second group allows to configure the map and source data.

Settings of google map field

Name Description
Application allows to select the source application; details...
Field GPS Coords allows to select the field from which the GPS coordinates will be taken; details...
Field For Marker Label allows to select the field whose value will be used as the marker name; details...
Add Item on dblclick allows the user to add a new element after double-clicking on the map; details...
Use current location allows to mark the current user location on the map; details...
View Name For Adding Item allows to select which view will be opened after double-click; details...
Map Style allows to select the style of the map; details...
Zoom on select allows to set the zoom value; details...

Application

This is the application whose fields will be used for mark.

Field GPS Coords

This is the field with the GPS coordinates that will be used to locate the marker.

Field For Marker Label

This field is used for the marker label. Its value will be displayed on the map under the marker.

Add Item On Dblclick

When this feature is enabled, the user can add a new item after double-clicking on the map.

Use Current Location

Due to this function, the marker of the user current location will be displayed on the map.

View Name For Adding Item

You can select the view which will be opened after double-clicking on the map. This function is available when Add Item On Dblclick is enabled.

Map Style

This function allows to select the style of the map.

  • Standart
  • Retro
  • Night

Zoom On Select

This is the zoom of the map on the selected item marker.

Hover/Click Action and Marker Filter

The following three groups of settings allow you to configure marker actions and filter items for display on the map.

The first one configures the hover action. The second one configures the click actions. And the last one allows you to add filters to customize which objects will displayed on the map as markers and which will not.

Hover action, click action and marker filter

Name Description
Hover Action allows you to select an action after hovering the cursor; details...
Popup Height allows to set the height of the popup; details...
Popup Width allows to set the width of the popup; details...
View For Hover allows to select the view that will be displayed in the popup; details...
Click Action allows to select the action after clicking on the marker; details...
Dialog Position allows to select the position in the browser window; details...
View For Click allows to select the view that will be displayed after clicking on the marker; details...

Hover Action

This function allows to select the action of the hover.

  • Show Popup
  • Google Popup
  • None

The current setting allows you to set the height of the popup.

Use this setting to customize the width of the popup.

View For Hover

This is the view that will be displayed in the popup window after hovering over the marker.

Click Action

This is the selected action that will happen after clicking on the markers. There are three options, but only two of them are actions. The last one allows you to disable any action:

  • Open Item
  • Show Dialog
  • None

Dialog Position

This position determines where the dialog box will be located after clicking on the markers.

View For Click

The current view will be opened after clicking on markers.

Markers

This group of settings allows to create and customize different styles of markers:

Markers for google map

Name Description
Icon Color allows to select the color of the marker icon; details...
Icon allows to select the marker icon; details...
Background Color allows to select the color of the marker background; details...
Conditions allows to set the conditions of the marker usability; details...
Edit allows to edit or delete the marker style; details...

Icon Color

This function opens the color picker and allows to select the icon color.

Icon

Use this function to select an icon to display in the marker.

Background Color

This is a color of the marker. You can select it using Background Color option.

Conditions

Use this option to set which items will use the current marker style.

Edit

This column contains two buttons. One of them allows to edit the style. The other one deletes the style.

Element Style

Despite the large number of settings and complex functionality, the google map has only standard style settings. There is also not much variety in the types of interpretation.

Style of google map element

Data Model

The google map data model contains all the configurations of the current item:

{
    "data_model": {
        "app_id": "28752",
        "click": {
            "side": "bottom",
            "type": "open_item"
        },
        "click_view_id": "1528082",
        "field_id": "679192",
        "filters_list": [],
        "filters_list_color": [{
            "background": "#5e3987",
            "color": "#ee4eb9",
            "filters_list": [],
            "marker": "configuration"
        }],
        "hover": {
            "side": "",
            "type": "show_popup"
        },
        "hover_view_id": "1528082",
        "interpretation": [],
        "label_field_id": "679191",
        "map_style": "retro",
        "popup_height": "10",
        "popup_width": "10",
        "zoom": 0
    }
}
Name Type Description
app_id string contains ID of the source application
click object contains click action settings
side string contains the side of the browser window where the popup will be opened
type string contains the type of the action after clicking on the marker
click_view_id string contains ID of the view that will be opened after clicking on the marker
field_id string contains ID of the field containing the gps-coordinates to determine the location of the markers on the map
filters_list array contains all items filters and their settings
filters_list_color array contains all markers styles and their settings
background string contains the hex code of the marker background color
color string contains hex code of the color of the marker icon
filters_list array contains all filters that determine which items will use current marker style
marker string contains name of the marker icon
hover object contains hover action settings
side string contains the side where the popup window will be located after hovering over the marker
type string contains the type of the action after hovering over the marker
hover_view_id string contains ID of the view that will be displayed in the popup window after hovering over the marker
interpretation array contains all element interpretation types
label_field_id string contains ID of the field that will be used for markers labels
map_style string contains selected style of the map
popup_height string contains height of the popup window
popup_width string contains width of the popup window
zoom number contains value of the map zoom

Filtration

You can filter the item by whether the map contains markers. Only the Value filter allows to do that.

Interpretation

The google map has two interpretation types:

Types of google map interpretation

Default

The first interpretation displays the element as an icon.

Map

The second type is an interactive map that displays markers.