Komponente „Advanced Place Details“

Die erweiterte Version der Place Details-Komponente bietet dieselben Funktionen wie Place Details Essentials. Außerdem können Sie:

  • Wählen Sie aus, ob der Ortsname angezeigt werden soll.
  • Konfigurieren Sie die Aktionsbuttons der Komponente.
  • Such- und Filteroptionen auf die angezeigten Rezensionen und Medien anwenden.
  • Benutzerdefinierte Anzeigenflächen erstellen

Tokens für agentische Anwendungen

Mit dem Token für die agentische Datenvisualisierung kann Ihre agentische App Elemente des Places UI Kit für die Orte in einer Antwort der Maps Experience Agent Tools (früher Maps Grounding Lite) ohne zusätzliche Kosten anzeigen. Weitere Informationen finden Sie unter Agentisches Token für die Datenvisualisierung.

Erweiterte Konfiguration von Place Details

Verwenden Sie AdvancedPlaceDetailsView oder AdvancedPlaceDetailsCompactView, um auf erweiterte Funktionen zuzugreifen.

Anzeigeoptionen für Inhalte

Mit den Enums in AdvancedPlaceDetailsContent können Sie festlegen, welche Inhalte angezeigt werden sollen. Sie können alle Inhalte konfigurieren, die auch in Place Details Essentials verfügbar sind, und festlegen, ob der Ortsname angezeigt werden soll.

Aktionsschaltflächen konfigurieren

Verwenden Sie die Methoden .cornerActions und .mainActions von AdvancedPlaceDetailsView oder AdvancedPlaceDetailsCompactView, um die Aktionsbuttons zu entfernen oder anzupassen.

Anforderungen an die visuelle Attribution

Kompakte Ansicht der Ortsdetails mit benutzerdefinierten Schaltflächen
Kompaktansicht der erweiterten Ortsdetails mit benutzerdefinierter Schaltfläche

Wichtig: Sie müssen Endnutzern gegenüber klar angeben, wenn über einen benutzerdefinierten Aktionsbutton Nutzerdaten an einen anderen Dritten als Google weitergegeben werden. Weitere Informationen finden Sie unter Anforderungen an den visuellen Urheberrechtshinweis.

Im Beispiel rechts ist ein benutzerdefiniertes Bild zu sehen, aus dem hervorgeht, dass Nutzerinformationen an „Altostrat“ gesendet werden.

Such- und Filteroptionen anwenden

Verwenden Sie die Methoden .searchMediaOptions und .searchReviewOptions von AdvancedPlaceDetailsView oder AdvancedPlaceDetailsCompactView, um die Suche und Filterung nach Medien oder Rezensionen zu aktivieren.

Benutzerdefinierte Anzeigenflächen erstellen

Optionen für die Platzierung benutzerdefinierter Anzeigenflächen

Mit benutzerdefinierten Inhaltsflächen können Sie eigene Inhalte (z. B. KI-generierte Zusammenfassungen, Zeitstempel für den Reiseplan oder benutzerdefinierte Badges) direkt in vordefinierte Layoutbereiche einfügen.

Wenn Sie benutzerdefinierte Anzeigenflächen hinzufügen möchten, verwenden Sie die Methode .placeDetailsCompactContentSlot von AdvancedPlaceDetailsCompactView. Die verfügbaren Positionen sind .basicSectionTop und .basicSectionBottom.

Anforderungen an Quellenangaben und Inhaltsvorschläge für Inhaltsflächen

Wenn ein benutzerdefinierter Inhaltsbereich eingebunden wird, wird die Offenlegung automatisch aktualisiert, um klarzustellen, welche Inhalte von Google und welche von Drittanbietern bereitgestellt werden.

Dos

Sorgen Sie für eine klare visuelle Hierarchie zwischen Google Place Details und benutzerdefinierten Inhalten, um Unklarheiten über die Quelle der Informationen zu vermeiden.

Unklarheiten über die Informationsquelle vermeiden

Dos

Bieten Sie lokalisierte, hochwertige Informationen, die auf die unmittelbaren Ziele Ihrer Nutzer zugeschnitten sind. Mit maßgeschneiderten Inhalten wie Echtzeit-Buchungsfenstern oder aktueller Verfügbarkeit können Nutzer schneller fundierte Entscheidungen treffen.

Wertvolle Statistiken bereitstellen

Nicht erlaubt

Duplizieren Sie keine vorhandenen Google-Ortsdetails wie Bewertungen, Rezensionen oder Öffnungszeiten, auch wenn Sie die von Google bereitgestellten Inhalte ausgeblendet haben. Andernfalls kann es zu Verwirrung bei den Nutzern hinsichtlich der Quelle der Inhalte kommen, also ob sie von Google oder einem Drittanbieter stammen.

Keine Duplikate vorhandener Google-Ortsdetails erstellen

Nicht erlaubt

Verwenden Sie keine Behauptungen oder Badges ohne Quellenangabe (z. B. „Top-Empfehlung!“), die fälschlicherweise als offizielle Empfehlungen von Google interpretiert werden könnten. Bei benutzerdefinierten Inhalten muss die Quelle explizit angegeben werden.

Keine Behauptungen oder Badges ohne Quellenangabe anzeigen

Nicht erlaubt

In benutzerdefinierten Ortscontainern dürfen keine Anzeigen, Marketingtexte, Werberabatte oder Aufforderungen zum Abonnieren enthalten sein.

Keine Anzeigen, Marketingtexte, Werberabatte oder Aufforderungen zum Abonnieren einfügen

Beispiele für erweiterte Ortsdetails

Lassen Sie den Ortsnamen weg.

Wenn Sie den Ortsnamen weglassen möchten, geben Sie .name nicht im Parameter content von AdvancedPlaceDetailsConfiguration an.

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

Aktionsbuttons entfernen

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 []
    }
  }
}

Benutzerdefinierte und vordefinierte Aktionen hinzufügen

In diesem Beispiel wird eine Option hinzugefügt, mit der ein Nutzer einen Ort als Favorit markieren oder die Markierung aufheben kann, sowie die vordefinierte Aktion In Maps öffnen.

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

Rezensionen und Medien filtern

In diesem Codebeispiel werden nur Medien und Rezensionen angezeigt, in denen „Kaffee“ erwähnt wird.

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

Content-Slots erstellen

In diesem Beispiel werden den Slots basicSectionTop und basicSectionBottom Inhalte hinzugefügt.

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