We use cookies to improve our service. Learn more.

Reference / App Components

Map Layout

Display your items as locations on a map.

Map is an alternate list layout. It displays each list item as a location on a map, as well as an optional list layout that users can toggle in the bottom right of the map. The map layout also supports user location.

Data

The Map layout has five properties that you can connect to the columns in your sheet.

The address should be a valid address or geocode.

The other four properties are assigned and behave in the same way as the List layout.

User location

We can enable a location button so users can find themselves on the map.

Allow users to show current location
Allow users to show current location

iOS users may find that the app is not able to locate their device. Often this is due to Safari settings blocking location access. To change this, head to settings/safari and enable or allow location access.

Design

Default view

The Map layout has two views that you can toggle between. In the design section, we can decide which of these users see first - the map or the list. We cannot turn off either view.

Visual type

We can choose from two options for Visual type, Street or Satellite.

At the bottom of the right-side panel is the Action section. By default, all lists have the action Show Detail Screen enabled. This means that when users tap on a list item they will go to that item's Details Screen.

However, we can disable this action and prevent your list items from doing this.

Troubleshooting Misplaced Pins

If we see map pins in the wrong locations, this is because we picked the wrong Address property (maybe you chose a column containing place names, not addresses?); or our addresses are incomplete or ambiguous.

We can ensure the correct pin location and make our app faster by providing coordinates instead of an address. For example, the Eiffel Tower is located at both:

  • Address: Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France
  • Coordinate: 48.8583701,2.2922926

When your sheet contains addresses, your app must lookup the coordinate before placing the pin on the map in a process called geocoding. This slows your app slightly and also can be expensive. If you use coordinates, however, the pin will be placed accurately, immediately, and without cost.

To lookup a coordinate, find the desired place in Google Maps and copy the coordinate from the URL. The format is two decimal numbers, separated by a comma. Sometimes the numbers are negative (e.g. 37.804884,-122.468803) so be sure to include the minus symbol but do not include the @ or / symbols:

You can simply use coordinates as address values, and you can mix addresses and coordinates in the same column.

Updated 2 weeks ago
Was this helpful?