Map view (configuration)

The map view is one of the optional elements that can be added to a grid page within the grid page layout block. A map can either display static predefined markers or be linked to fields on the grid, from which the marker coordinates, such as latitude and longitude or city name, will be retrieved. You can use this view to visualize data related to location. Its availability can be configured per permission set (for the parent layout block).

To add an Earth map view to a grid page

1. In CMS, go to Contents.
2. Select the content node, and then select a grid page into which you want to add a map view.
3. On the General tab, set the Width setting to the desired width, making sure that this width combined with the width of the layout block does not exceed 12.
4. Select the icon of the grid page node (the icon appears when you point to the node title).
5. Select Grid layout block in the Create dialog window that appears.
6. On the header, enter the layout block name that will be used to identify it in CMS.
7. On the General tab, in the Width settings field, specify the width of the layout block to have it displayed to the side of the grid. The layout block width in combination with the parent grid's width must not exceed 12. Otherwise, the layout block will be displayed below the grid.
   
8. On the Layout settings tab, in the View element minimum height setting, specify the minimum height of the layout block in pixels. The recommended height: 600 or above.
9. If you want the map view to be shown before the grid (on the left side or above the grid depending on the grid layout block width settings), enable the Postion switch. If you leave it disabled, the map view will be shown after the grid (on the right side or below the grid depending on the grid layout block width settings).
10. You can leave other layout block settings with default values. The layout block will serve as a container for the map view. Select Save and publish.
11. Ensure that this layout block that will contain a map view is the first child node under the grid page node. If necessary, use node sorting (select and hold (or right-click) the node, and then select Sort) to put right under the parent node.
12. Select the icon of the created grid page node.
13. Select Map view.
    
14. On the header, enter the map view name that will be used to identify it in CMS.
15. On the General tab, configure the settings as described below:
    • Title – Specifies the title of the map view that will be displayed on the page. If you leave this field empty, the map view title will not be displayed.
    • Subtitle – Specifies the subtitle of the map view that will be displayed on the page below the title. If you leave this field empty, the map view subtitle will not be displayed.
    • Icon – Specifies the image that will be displayed next to the map view title.
    • Width settings – Specifies the settings where you can configure adaptive width of the map view within the layout block.
    • Hide element –  This setting hides the map view from the grid page. It can be configured per member group. In the layout block page settings, on the General tab, in the Hide element setting, select one or several member groups, for which this map view will be hidden. Alternatively, you can select the ~All~ check box to hide it for all member groups (without the necessity to select every member group's check box) or select the Hide element check box to have all member groups selected at once.
    • Background color – Specifies the color that will be used as solid filled background for the map view.
    • Background image – Specifies the image that will be used as a background for the map view.
    • Description – Specifies a description of this map view that will be displayed below the title and subtitle.
    • Navigate-to page – Specifies the portal page that will be displayed when the portal member selects this map view. For a map view, leave this setting empty.
    • Content-from page – Specifies the portal page that will be displayed instead of the created page. The path on the address bar will be that of the original page. For a map view, leave this setting empty.
    • Redirect-to page – Specifies the portal page that will be displayed instead of the created page. The path on the address bar will be that of the target page. For a map view, leave this setting empty.
16. On the Map settings tab, configure the settings as described below:
    • Map provider – Specifies the map provider for the map view. The map provider defines the look of the map and its markers. Select one of the available providers.
    • Static coordinates – Specifies the settings where you can configure map markers with static coordinates. These static markers will always be displayed on this map view. You can add more than one static marker if necessary. To add a static marker, select the icon, and then fill in the settings as described below:
      • Latitude value – Specifies the distance north or south of the equator measured in degrees for this static marker.
      • Longitude value – Specifies the distance east or west of the equator measured in degrees for this static marker.
      • Static coordinate marker – Specifies the image of the marker icon. You can select an image from the library, upload your image or leave this field empty to use the default image of the map provider.
      • Coordinate tooltip – Specifies the tooltip that will be displayed when selecting this static marker.
    • Dynamic coordinates – Specifies the settings where you can configure map markers with dynamic coordinates. Dynamic marker may retrieve coordinates (either latitude + longitude or city name) from field values on a record. You can add more than one dynamic marker if necessary. To add a dynamic marker, select the icon, and then fill in the settings as described below:
      • Latitude value – Specifies the name of a field from the data source entity, the value of which will be used to retrieve the distance north or south of the equator measured in degrees for this dynamic marker marker. You can leave this setting empty if you want to use a city name to identify the marker location (the Address field setting).
      • Longitude value – Specifies the name of a field from the data source entity, the value of which will be used to retrieve the distance east or west of the equator measured in degrees for this static marker.
      • Dynamic coordinate marker - Specifies the path to the image that will be used as a map marker. You can use a variable to have different marker icons for different values. For example: [[Transport]].png where Transport is the name of a field from the source data entity, the value of which will be used as an indicator of which icon to use. Thus, depending on the transport, a different map marker will be used. If you are going to use a dynamic map marker icon, ensure that for every possible value of the specified variable field, you have an image with the same file name in the portal image library. You can leave this setting empty to use the same default marker.
      • Coordinate tooltip - Specifies the tooltip that will be shown when selecting the dynamic marker. You can use a variable field to retrieve this tooltip from a field value. E.g. [[Description]] means that the Description field value will be used as a marker tooltip.
      • Address field - Specifies the variable field the value of which will be used to identify the marker location on the map. You must specify a field in double square brackets, the value of which will contain a city name. E.g. [[DestinationName]]. You can leave this setting empty if you want to use a city name to identify the marker location (the Address field setting).
    • Minimum zoom – Specifies an integer that defines how far you can zoom out on the map.
    • Maximum zoom – Specifies an integer that defines how close you can zoom in on the map.
    • Start zoom – Specifies an integer that defines the starting zoom value.
    • Zoom step – Specifies the zoom step that will be used when you zoom out or zoom in on the map.
    • Show selected record coordinates only – Specifies whether record coordinates, represented by map markers, will be shown only for the currently selected record on the grid or for all records. Static coordinates are shown irrespective of this setting.
    • Auto-switch focus between coordinates – Specifies whether a popup tooltip will be displayed above the marker when a record is selected.
    • Element minimum height – Specifies the minimum height of the map view. If you leave this setting empty, the minimum height of the layout block will be used.

16. Select Save and publish.