The Mapping screen type allows you to display Data Source rows as map pins on a full-screen map in your app. We’ve added customization options, such as control over pin colors, callout display, and user interactions, to enable dynamic scenarios when the user selects a map pin.
Smart clustering of data points means that the Mapping screen can handle the display of thousands of pins while remaining responsive and engaging to your users.
You can specify a default formula filter to apply to the Data Source rows displayed on a Mapping screen. This is helpful in displaying just a subset of the Data Source rows – e.g., all rows within a certain state or city. Options are also provided to allow the user to specify their own custom filters.
By default, the auto-complete search in these Screens will filter rows based on the user’s search text matching anywhere within the displayed row values. Our “Search Pattern” option allows you to specify a custom regular expression to replace the default matching behavior.
Displaying your data on a map adds another level of flexibility and productivity to your clients’ apps, as users can geographically visualize their data.
For detailed instructions on how to set up a mapping screen, click here.
Common Questions About Mapping Screens
How can I control the color of the location pins on a mapping screen?
If you wish to apply conditional coloring to map pins, you must set up Conditional Display Rules on your Data Source.
- Go to the Data Source -> Rows page.
- There is a little “cog” icon in each column header on the Rows page – click this icon on the desired column to show the Column Settings dialog.
- You can then add Conditional Display Rules to control the styling of row data.
Click the question mark icons for detailed hints and information on creating a rule formula.
What coordinate format must I use for row values in the Pin data source column?
The column must contain the location coordinates in space-separated decimal degrees (latitude longitude).
e.g., New York City is: 40.7142700 -74.0059700
If I have two entries with the exact same geo coordinates, how can I access the popup details of each pin?
If multiple rows are at the same location, the app will show a pin with a number on it.
Tap the pin to “cycle” through each row at that coordinate. Tapping 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 for performance purposes.
This enables a smooth map experience for the user.
As the user zooms down 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 color of these cluster icons.