Work with maps

Address and LatLong data can be displayed on a Google Map. You can click a map pin to get driving directions.

LatLong data

LatLong data is represented as comma-separated decimal values, as in: 44.2456, -122.3348

LatLong data can be captured in a form field when editing or adding rows via the LatLong and ChangeLocation column types.

The current location button on the LatLong input uses high-accuracy GPS location capture on your device, which is potentially time-consuming and battery-intensive. Using a ChangeLocation column or an app formula or initial value expression of HERE() for a LatLong column enables passive location capture within the form, but the accuracy may be reduced compared to using the current location button. 

XY data

The XY column type represents a position within an image that you provide. When a map view is configured with an XY-type Map column, it will display the image in place of the usual map.

To enable an XY image map, change the column definition of your location data to XY and add a link to your hosted image (as quoted text or an expression) in the Background image for the XY coordinates setting.

background image for the XY coordinates

KML Layers

KML (Keyhole Markup Language) is a file format used to display geographic data, most commonly on platforms like Google Earth or Google Maps, that allows for embedding and displaying location points, borders and shapes with different styles.

To enable a KML layer in your map, edit the column definition of any Address or LatLong column type to add a link to a hosted KML file in the Optional Url form KML File setting. 

There are some constraints on the size of KML files that can be displayed:

  • Maximum fetched file size (raw or compressed): 3MB
  • Maximum uncompressed KML file size: 10MB
  • Maximum number of network links: 10
  • Maximum number of total document-wide features: 1000
  • Maximum number of KML layers: 10 to 20

These constraints are established by Google Maps; we do not have the ability to modify them.

Download an example of a KML file that fits these constraints:

Here are a couple of sites with interesting KML files:

Address data

When you enter an address, always specify the complete address including the city, state (if any), and country. This makes it easier for Google Maps to locate the address. 

If an Address is not mapped correctly, look up the address on Google Maps to see if there is a problem with the address. If you add many addresses at once to the data source, there may be a delay before you see all the addresses appear on the map within the app because each address must be geocoded before its position can be displayed.

Map pins

Each location is displayed as a map pin. For performance reasons, only a limited number of pins can be displayed at once. If the total pins exceed the limit, the map will prioritize showing pins closest to the center of the current view.

You can control the number of pins displayed by setting the Map pin limit setting in the UX > Options tab of the app editor:

Map pin limit in the Map View options

Maps can be displayed in road or aerial view.

The map can be zoomed and panned. By default, the map is zoomed to show all the pins. If your map includes locations in both Australia and Canada, it may be zoomed to show half the world.

You can click or tap a map pin to select it. When you select a map pin:

  1. The map centers on the selected map pin.
  2. Information about the selected map pin is displayed below the map or in a sidebar depending on the screen size. The sidebar displays a detail view of the record as you would see if selecting the row in a table view. The compact view displays a single deck view row at the bottom of the screen. Both detail views include a built-in driving directions action (car icon) that attempts to launch Google Navigation from the current location to that destination (iOS users will need to install Google Maps for this feature to work). They can both be configured using reference views.

Customize map pins

You can customize the color and icon style of map pins using format rules. You can apply format rules selectively to format some map pins one way, and other map pins another way. This allows you to highlight certain map pins or to categorize map pins into groups.

To customize map pins:

  1. In the editor, open the UX > Format Rules tab.

  2. Click +New Rule to create a new format rule.

  3. In the For this data drop-down, select the table containing the Address or LatLong field.

  4. In the Then format these columns drop-down select the name of the Address or LatLong field.

  5. In the Highlight color property enter the map pin color you wish. For example, #FF0000 is red, #00FF00 is green, #0000FF is blue, #FFFF00 is yellow, #00FFFF is cyan, #FF00FF is magenta, and so forth. 

  6. In the icon drop-down, select the style of icon you wish. For example, fa-car.

  7. In the If this condition is true property, enter a Yes/No expression. The format rule will be applied when the expression is TRUE.

Create a format rule for each map pin format you wish. Specify the appropriate If this condition is true expression to apply that format rule to the map pins you wish.

Driving directions

You must install Google Maps on iPhone and iPad devices to obtain driving directions.

To obtain driving directions, click the map pin. A small car icon will appear at the bottom of the app. Click the car icon to activate Google Maps driving directions.


For more information regarding maps, see Use the Map View Feature to Visualize Addresses in your App.

Was this helpful?
How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center