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

Tampilan ringkas detail tempat dengan tombol yang dapat disesuaikan
Tampilan ringkas Place Details lanjutan dengan tombol yang dapat disesuaikan

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

Opsi penempatan 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.

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.

Memberikan insight bernilai tinggi

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.

Jangan menduplikasi detail Google Place yang ada

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.

Jangan menampilkan klaim atau badge tanpa atribusi

Larangan

Jangan sertakan iklan, teks pemasaran, diskon promosi, atau perintah langganan dalam penampung tempat kustom.

Jangan sertakan iklan, teks pemasaran, diskon promosi, atau perintah langganan

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)
      }
    }
}