進階 Place List 元件
進階地點清單元件可讓您定義及顯示地點清單。您最多可以列出 20 個地點,這些地點必須來自 Place Details 元件支援的同一組 ID (地點 ID、地點資源名稱或經緯度座標)。
你可以選擇水平或垂直清單顯示。預設方向為直向。每個清單項目提供的資訊和設定選項,與精簡和完整地點詳細資料資訊卡相同。
使用 AdvancedPlaceListView 的 orientation、placeIdentifiers 和 configuration 參數建立清單。
帳單
每次提出清單要求時,系統都會向您收費,且清單的任何變更都是新的計費事件。
代理應用程式的權杖
有了代理資料視覺化權杖,代理應用程式就能在地圖體驗代理工具 (舊稱 Maps Grounding Lite) 回應中,顯示地點的 Places UI Kit 元素,不需額外付費。詳情請參閱「代理式資料視覺化權杖」。
範例
這個範例會根據地點 ID 建立清單。configuration 參數會指定每個清單項目列出地址、評分和類型,以及其他視覺規格。系統會建立主要動作,讓使用者將每個清單項目加入或移出收藏。每個清單項目的角落動作都已停用。
Swift
struct AdvancedPlaceListDemoView: View { private let configuration = AdvancedPlaceListConfiguration( content: [.address(), .rating(), .type()], preferTruncation: true, theme: PlacesMaterialTheme(), attributionPosition: .bottom, mediaSize = .medium, selectable: true ) @State private var placeIdentifiers = [.placeID("ChIJj61dQgK6j4AR4GeTYWZsKWw")] @State private var favoritePlaces: Set<String> = [] var body: some View { AdvancedPlaceListView( orientation: .horizontal, // default is vertical placeIdentifiers: placeIdentifiers, configuration: configuration ) .onLoad { results in for result in results { switch result { case .success(let place) print("place: \(place)") case .failure(let error) print("error: \(error)") } } } .onPlaceSelected { place, index in print("place: \(place)") print("index: \(index)") } .mainActions { place in var actions: [MainPlaceActionElement] = [] let placeID = place.placeID! if self.favoritePlaces.contains(placeID) { actions.append( .action( MainPlaceAction( image: Image(systemName: "heart.fill"), label: "Unfavorite" ) { _ in self.toggleFavorite(placeID) } ) ) } else { actions.append( .action( MainPlaceAction( image: Image(systemName: "heart"), label: "Favorite" ) { _ in self.toggleFavorite(placeID) } ) ) } actions.append(.actionId(.openMap(style: .primary))) return actions } // Ensures that there are no corner actions. .cornerActions { _ in return [] } } func toggleFavorite(_ placeID: String) { if favoritePlaces.contains(placeID) { favoritePlaces.remove(placeID) } else { favoritePlaces.insert(placeID) } } }