[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThe Place List template displays an ordered list of locations on a map, ideal for point-of-interest apps, and includes components like headers, action strips, list rows, and markers.\u003c/p\u003e\n"],["\u003cp\u003eMarkers link list items with map locations and can be customized with text, icons, or images, and include map markers, list markers, and anchor markers.\u003c/p\u003e\n"],["\u003cp\u003eList rows must display duration or distance, have an associated action, and be relevant to the app type; they should have a corresponding map marker and be limited to the closest or most relevant locations.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should consider supporting content refresh to allow users to update the list after driving out of the original range.\u003c/p\u003e\n"]]],[],null,["# Place List (map) template\n\n\u003cbr /\u003e\n\nThe Place List template presents an ordered list of locations (or containers\nfor sublists), overlaid on a map provided by the app library.\n**Note:** This template is for point-of-interest apps. \n**Includes:**\n\n- [Header](/cars/design/create-apps/apps-for-drivers/components/header) (in card) with optional refresh button for users to request a list update (doesn't add to [step count](/cars/design/create-apps/apps-for-drivers/plan-task-flows#steps-refreshes))\n- [Action strip](/cars/design/create-apps/apps-for-drivers/components/action-strip) (optional)\n- Base map (full-screen, not drawn by apps)\n- [List rows](/cars/design/create-apps/apps-for-drivers/components/row) within limits\\*\n- [Markers](#markers)\n\n\u003cbr /\u003e\n\n| **\\* Note:** The number of list rows allowed to be shown depends on the vehicle. To retrieve the list row limit for a given vehicle, use the [ConstraintManager API](https://developer.android.com/training/cars/apps#constraint-manager).\n\nMarkers\n-------\n\nMarkers are used to link list items with locations on the map or to identify an\nanchor location. Markers can be designated as tappable (as can any area on a\nmap), so that users can tap a marker to trigger an action such as displaying\ninformation about that marker.\nCustomize your markers to match your app's branding\n\n### Types of markers\n\n1. **Map marker**: On map, labeled with one of the following: text (up to 3 letters), an icon, or an image\n2. **List marker** (not shown): On list, marker that corresponds to map marker, with matching metadata and image or icon asset\n3. **Anchor marker** (optional): On map, used to show center of search area\n\nApps can customize the background color of markers with any color. The color\nused for the map marker is applied to the list marker.\n\nPlace List (map) template examples\n----------------------------------\n\nLocation list with corresponding map markers and\nanchor marker (Android Auto example)\n\nList with carets pointing to sublists (AAOS\nexample)\n\n\u003cbr /\u003e\n\nPlace List (map) template UX requirements\n-----------------------------------------\n\nApp developers:\n\n|------------|------------------------------------------------------------------------------------------------------------------------------------|\n| **MUST** | Show duration or distance for each list item (except for container items). |\n| **MUST** | Associate an action with each list row (information-only rows are not allowed). |\n| **MUST** | Display only locations that are appropriate to the app type (parking spots for parking apps, charging stations for charging apps). |\n| **SHOULD** | Include at least one location or browsable list item (container) on the list. |\n| **SHOULD** | Show a corresponding marker on the map for each location on the list. |\n| **SHOULD** | Limit locations to those that are closest or most relevant. |\n| **SHOULD** | Consider supporting content refresh for the list, so users can update it after driving out of range of the original list. |"]]