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
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
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.
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.
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.
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.
Nicht erlaubt
In benutzerdefinierten Ortscontainern dürfen keine Anzeigen, Marketingtexte, Werberabatte oder Aufforderungen zum Abonnieren enthalten sein.
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) } } }