The Place List template presents an ordered list of locations (or containers for sublists), overlaid on a map provided by the app library.
Place list (map) template includes:
- Header (in card) with optional refresh button for users to request a list update (doesn't add to step count)
- Action strip (optional)
- Base map (full-screen, not drawn by apps)
- List rows within limits*
- Markers
Markers
Use markers to link list items with locations on the map or to identify an anchor location. You can designate markers as tappable (as with any area on a map) to allow users to tap a marker to trigger an action such as displaying information about that marker.
Types of markers:
- Map marker: on map, labeled with one of the following: text (up to 3 letters), an icon, or an image
- List marker (not shows): On list, marker that corresponds to map marker, with matching metadata and image or icon asset
- Anchor marker (optional): On map, used to show center of search area
Apps can customize the background color of markers with any color. The color used for the map marker is applied to the list marker.
Place List (map) template examples
Place list (map) template UX requirements
App developers:
| MUST | Show duration or distance for each list item (except for browsable items). |
| MUST | Associate an action with each list row (information-only rows are not allowed). |
| SHOULD | Include at least one location or browsable list item (container) on the list. |
| SHOULD | Show a corresponding marker on the map for each location on the list. |
| SHOULD | Limit locations to those that are closest or most relevant. |
| SHOULD | Consider supporting content refresh for the list, so users can update it after driving out of range of the original list. |
Resources
| Type | Link |
| API reference |
PlaceListMapTemplate
,
PlaceListMapTemplate.Builder
|
| Developer's guide | Access the map templates |