Komponen Place Details Advanced
Komponen Place Details versi Advanced menawarkan fitur yang sama dengan Places Details Essentials. Google Pay juga memungkinkan Anda:
- Pilih apakah Nama tempat akan ditampilkan.
- Konfigurasikan tombol tindakan komponen.
- Terapkan opsi penelusuran dan pemfilteran ke ulasan dan media yang ditampilkan.
- Membuat slot konten kustom.
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.
Konfigurasi Place Details lanjutan
Gunakan AdvancedPlaceDetailsView atau AdvancedPlaceDetailsCompactView untuk mengakses fitur lanjutan.
Opsi tampilan konten
Anda dapat menentukan konten yang akan ditampilkan menggunakan enum di AdvancedPlaceDetailsContent. Anda dapat mengonfigurasi semua konten yang sama seperti Places Details Essentials, serta memilih apakah nama Tempat akan ditampilkan.
Mengonfigurasi tombol tindakan
Gunakan metode .cornerActions dan .mainActions dari AdvancedPlaceDetailsView atau AdvancedPlaceDetailsCompactView untuk menghapus atau menyesuaikan tombol tindakan.
Persyaratan atribusi visual
Penting: Anda harus menjelaskan kepada pengguna akhir saat tombol tindakan kustom akan membagikan informasi pengguna kepada pihak ketiga selain Google. Lihat persyaratan atribusi visual.
Contoh di sebelah kanan menunjukkan gambar kustom yang memperjelas bahwa informasi pengguna akan dikirim ke "Altostrat".
Menerapkan opsi penelusuran dan pemfilteran
Gunakan metode .searchMediaOptions dan .searchReviewOptions dari AdvancedPlaceDetailsView atau AdvancedPlaceDetailsCompactView untuk mengaktifkan penelusuran dan pemfilteran untuk media atau ulasan.
Membuat slot konten kustom
Slot konten kustom memungkinkan Anda menambahkan konten Anda sendiri (seperti ringkasan buatan AI, stempel waktu itinerari, atau badge kustom) langsung ke zona tata letak yang telah ditentukan.
Untuk menambahkan slot konten kustom, gunakan metode .placeDetailsCompactContentSlot dari AdvancedPlaceDetailsCompactView. Posisi yang tersedia adalah .basicSectionTop dan .basicSectionBottom.
Persyaratan atribusi dan saran konten untuk slot konten
Saat slot konten kustom dipasang, pengungkapan akan otomatis diperbarui untuk memperjelas konten mana yang disediakan oleh Google dan bahwa beberapa konten disediakan oleh pihak ketiga.
Anjuran
Pertahankan hierarki visual yang jelas antara Place Details Google dan konten kustom untuk mencegah ambiguitas tentang sumber informasi.
Anjuran
Pertimbangkan insight bernilai tinggi dan dilokalkan yang disesuaikan dengan sasaran langsung pengguna Anda. Konten yang disesuaikan seperti periode pemesanan real-time atau ketersediaan saat ini membantu pengguna membuat keputusan yang lebih cepat dan tepat.
Larangan
Jangan menduplikasi Place Details Google yang ada, seperti rating, ulasan, atau jam buka, meskipun Anda telah menyembunyikan konten yang disediakan Google. Tindakan ini dapat membingungkan pengguna tentang sumber konten dan apakah konten tersebut berasal dari Google atau pihak ketiga.
Larangan
Jangan menampilkan klaim atau badge tanpa atribusi (misalnya, "Rekomendasi teratas!") yang dapat disalahartikan sebagai dukungan resmi Google. Konten kustom harus secara eksplisit mencantumkan sumbernya.
Larangan
Jangan sertakan iklan, teks pemasaran, diskon promosi, atau perintah langganan dalam penampung tempat kustom.
Contoh Place Details lanjutan
Menghilangkan Nama tempat
Untuk menghilangkan Nama tempat, jangan sertakan.name dalam parameter content dari AdvancedPlaceDetailsConfiguration.
Swift
struct DemoView: View { static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU" // Query for loading the place details component. @State var query: PlaceDetailsQuery = PlaceDetailsQuery( identifier: .placeID(peetsCoffeePlaceID) ) @State private var favoritePlaces: Set<String> = [] var body: some View { AdvancedPlaceDetailsView( query: $query, configuration: AdvancedPlaceDetailsConfiguration( content:[.address()], theme: PlacesMaterialTheme() ), placeDetailsCallback: { result in if let place = result.place { print("Place: \(place.description)") } else { print("Error: \(String(describing: result.error))") } } ) } }
Menghapus tombol tindakan
Swift
struct DemoView: View { static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU" @State var query: PlaceDetailsQuery = PlaceDetailsQuery( identifier: .placeID(peetsCoffeePlaceID) ) var body: some View { AdvancedPlaceDetailsView( query: $query, configuration: AdvancedPlaceDetailsConfiguration( content: AdvancedPlaceDetailsView.allContent, theme: PlacesMaterialTheme() ), placeDetailsCallback: { result in if let place = result.place { print("Place: \(place.description)") } else { print("Error: \(String(describing: result.error))") } } ) .mainActions{ _ in return [] } } }
Menambahkan tindakan kustom dan standar
Contoh ini menambahkan opsi bagi pengguna untuk memfavoritkan atau membatalkan favorit tempat, beserta tindakan Buka di Maps yang telah ditentukan.
Swift
struct DemoView: View { static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU" @State var query: PlaceDetailsQuery = PlaceDetailsQuery( identifier: .placeID(peetsCoffeePlaceID) ) @State var favoritePlaces: Set<String> = [] var body: some View { AdvancedPlaceDetailsView( query: $query, configuration: AdvancedPlaceDetailsConfiguration( content: AdvancedPlaceDetailsView.allContent, theme: PlacesMaterialTheme() ), placeDetailsCallback: { result in if let place = result.place { print("Place: \(place.description)") } else { print("Error: \(String(describing: result.error))") } } ) .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 } .cornerActions { place in var actions: [CornerPlaceActionElement] = [] let placeID = place.placeID! if self.favoritePlaces.contains(placeID) { actions.append( .action( CornerPlaceAction( image: Image(systemName: "heart.fill"), accessibilityLabel: "Unfavorite", ) { _ in self.toggleFavorite(placeID) } ) ) } else { actions.append( .action( CornerPlaceAction( image: Image(systemName: "heart"), accessibilityLabel: "Favorite", ) { _ in self.toggleFavorite(placeID) } ) ) } actions.append(.actionId(.openMap(style: .primary))) return actions } } func toggleFavorite(_ placeID: String) { if favoritePlaces.contains(placeID) { favoritePlaces.remove(placeID) } else { favoritePlaces.insert(placeID) } } }
Memfilter ulasan dan media
Contoh kode ini hanya menampilkan media dan ulasan yang menyebutkan "kopi".
Swift
struct DemoView: View { static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU" @State var query: PlaceDetailsQuery = PlaceDetailsQuery( identifier: .placeID(peetsCoffeePlaceID) ) let searchMediaOptions = SearchMediaOptions(query: "coffee") let searchReviewsOptions = SearchReviewsOptions(query: "coffee") var body: some View { AdvancedPlaceDetailsView( query: $query, configuration: AdvancedPlaceDetailsConfiguration( content: [.media(), .reviews()], theme: PlacesMaterialTheme() ), placeDetailsCallback: { _ in } ) .searchMediaOptions(searchMediaOptions) { results in guard let result = results.first else { return } switch result { case .success(let summary): print("Summary: \(summary)") case .failure(let error): print("Error: \(error)") } } .searchReviewsOptions(searchReviewsOptions) { results in guard let result = results.first else { return } switch result { case .success(let summary): print("Summary: \(summary)") case .failure(let error): print("Error: \(error)") } } } }
Membuat slot konten
Contoh ini menambahkan konten ke slot basicSectionTop dan basicSectionBottom.
Swift
import SwiftUI import PlacesSwift struct ItineraryCard: View { static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU" @State var query: PlaceDetailsQuery = PlaceDetailsQuery( identifier: .placeID(peetsCoffeePlaceID) ) var body: some View { AdvancedPlaceDetailsCompactView( orientation: .vertical, query: $query, configuration: AdvancedPlaceDetailsCompactConfiguration( content: AdvancedPlaceDetailsCompactView.allContent, theme: PlacesMaterialTheme() ), placeDetailsCallback: { _ in } ) .placeDetailsCompactContentSlot(position: .basicSectionTop) { place in Text("Day 2 • 2:30 PM") .font(.caption) .fontWeight(.bold) .foregroundColor(.accentColor) } .placeDetailsCompactContentSlot(position: .basicSectionBottom) { place in VStack(alignment: .leading, spacing: 4) { Text("AI Notes") .font(.caption) .bold() Text("Great quiet atmosphere for morning meetings. Famous for house-roasted pour-overs.") .font(.footnote) .foregroundColor(.secondary) } .padding(8) .background(Color(.systemGray6)) .cornerRadius(8) } } }