A mapping screen provides the ability to display data source rows as map pins on a map. Displaying your data in map form increases flexibility and productivity, as your users can visualize their data in a geographic way.

We’ve added customization options such as pin colours, callout display, and user interactions to enable dynamic scenarios when the user selects a map pin.

The clustering of data points ensures that the mapping screens can accommodate displaying thousands of pins, while remaining responsive and engaging to users.

You can apply a default formula filter to the data source rows displayed in a mapping screen. This is helpful when displaying a subset of the data source rows, e.g. all rows within a certain state or city. We also provide options for users to specify their own custom filters.

By default, the auto-complete search in mapping screens will filter rows based on the users search text, matching anywhere within the displayed row values. Our 'Search Pattern' option allows you to specify a custom expression to replace the default matching behaviour.

Create a mapping screen 

1. Using the navigation menu on the MESH platform click on Apps, and select Screens from the drop down menu. Click on +ADD NEW in the top right corner. 

2. Choose 'Map a Data Source', and then enter a name for your screen.

3. Select the target data source to display as pins on your map. This data source must contain a column with location co-ordinates in space separated decimal degrees (latitude/ longitude). e.g. New York City is: 40.7142700 -74.0059700.

4. Click CREATE+ to create your new mapping screen. This will take you into the mapping screen designer.

5. Once in the designer, click on the pin in the preview area. This will display the pin properties available to configure. Make sure that the 'Pin Co-ordinates' property is correctly set to your location column.

6. You can configure other options, such as the pin's popup text as desired. Click the 'Save' button to save your changes.

7. Be sure to use the 'Test' button to test your changes on the app. When you are satisfied with the page click 'Publish' to make your new mapping screen available to users.

Common questions about mapping screens

How can I control the colour of the location pins in a mapping screen? 

If you want to apply conditional colouring to map pins, you must set up 'Conditional Display Rules' on your data source.

1. Using the navigation menu, click on Connected Data, and select Data Sources from the drop down. Hover over your desired data source and click on 'rows'.

2. Click on the 'cog' icon of the desired column to show the 'Advanced Column Settings'.

3. Use the 'Conditional Display Rules' option to control styling of row data by clicking on +Add display rule. 

Note: Use the question mark icons for detailed hints and information on how to create a rule formula.

What co-ordinate format should I use for row values in the pin data source column?

As mentioned above, the column must contain location co-ordinates in space-separated decimal degrees (latitude/longitude).
i.e. New York City is: 40.7142700 -74.0059700

I have two entries with the exact same geo coordinates, how can I access the popup details of each pin separately?

If there are multiple rows at the same location each pin will have a number on it. Tap the pin to 'cycle' through each row at that co-ordinate. Doing this will also display the popup details for that specific row.

What is the 'Cluster Icon Style' property for?

If your data source contains many rows within a specific area of the map, the app will automatically cluster pins at various zoom levels. This allows for a smooth map experience for the user. As the user zooms into a specific area, the clusters will progressively break up into individual pins.
The Cluster Icon Style option in the mapping designer allows you to specify the colour of these cluster icons.

Did this answer your question?