Komponen Place List lanjutan
Komponen Advanced Place List memungkinkan Anda menentukan dan menampilkan daftar tempat. Anda dapat mencantumkan hingga 20 tempat dari kumpulan identitas yang sama yang didukung oleh komponen Place Details (ID Tempat, Nama Resource Tempat, atau koordinat lintang/bujur).
Anda dapat memilih dari tampilan daftar horizontal atau vertikal. Orientasi defaultnya adalah vertikal. Informasi dan opsi konfigurasi yang sama dengan kartu Place Details ringkas dan lengkap tersedia untuk setiap item daftar.
Gunakan parameter orientation, placeIdentifiers, dan configuration dari AdvancedPlaceListView untuk membuat daftar.
Penagihan
Anda akan ditagih untuk setiap permintaan daftar, dan setiap perubahan pada daftar merupakan peristiwa baru yang dapat ditagih.
Token untuk aplikasi agentic
Token visualisasi data agentic memungkinkan aplikasi agentic Anda menampilkan elemen Kit UI Tempat untuk tempat dalam respons alat agentic Maps Experience (sebelumnya Maps Grounding Lite) tanpa biaya tambahan. Untuk mengetahui informasi selengkapnya, lihat Token visualisasi data agentic.
Contoh
Contoh ini membuat daftar berdasarkan ID tempat. Parameter configuration menentukan bahwa setiap item daftar akan mencantumkan alamat, rating, dan jenis, beserta spesifikasi visual lainnya. Tindakan utama dibuat untuk memungkinkan pengguna memfavoritkan atau membatalkan favorit setiap item daftar. Tindakan sudut dinonaktifkan untuk setiap item daftar.
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) } } }