Komponent Zaawansowane informacje o miejscu
Wersja Zaawansowana komponentu informacje o miejscu oferuje te same funkcje co informacje o miejscu Essentials. Możesz też:
- Wybierz, czy nazwa miejsca ma być wyświetlana.
- Skonfiguruj przyciski poleceń komponentu.
- stosować opcje wyszukiwania i filtrowania do wyświetlanych opinii i multimediów;
- Tworzenie niestandardowych boksów treści.
Tokeny dla aplikacji agentowych
Token wizualizacji danych agentowych umożliwia aplikacji agentowej wyświetlanie elementów interfejsu Places UI Kit dla miejsc w odpowiedzi narzędzi agentowych Maps Experience (dawniej Grounding Lite w Mapach) bez dodatkowych opłat. Więcej informacji znajdziesz w artykule Token wizualizacji danych agentowych.
Zaawansowana konfiguracja informacji o miejscu
Aby uzyskać dostęp do funkcji zaawansowanych, użyj AdvancedPlaceDetailsView lub AdvancedPlaceDetailsCompactView.
Opcje wyświetlania treści
Możesz określić, które treści mają być wyświetlane, używając typów wyliczeniowych w AdvancedPlaceDetailsContent. Możesz skonfigurować wszystkie te same treści co w przypadku podstawowych informacji o miejscu, a także wybrać, czy ma być wyświetlana nazwa miejsca.
Konfigurowanie przycisków poleceń
Aby usunąć lub dostosować przyciski poleceń, użyj metod .cornerActions i .mainActions klasy AdvancedPlaceDetailsView lub AdvancedPlaceDetailsCompactView.
Wymagania dotyczące podania źródła wizualnego
Ważne: musisz wyraźnie poinformować użytkowników, kiedy przycisk działania niestandardowego będzie udostępniać informacje o użytkowniku firmie innej niż Google. Zobacz wymagania dotyczące podania źródła wizualnego.
Przykład po prawej stronie pokazuje niestandardowy obraz, który wyraźnie wskazuje, że informacje o użytkowniku zostaną wysłane do „Altostrat”.
Stosowanie opcji wyszukiwania i filtrowania
Aby włączyć wyszukiwanie i filtrowanie multimediów lub opinii, użyj metod .searchMediaOptions i .searchReviewOptions w AdvancedPlaceDetailsView lub AdvancedPlaceDetailsCompactView.
Tworzenie niestandardowych boksów treści
Niestandardowe boksy na treści umożliwiają dodawanie własnych treści (takich jak podsumowania wygenerowane przez AI, sygnatury czasowe planu podróży lub niestandardowe plakietki) bezpośrednio do wstępnie zdefiniowanych stref układu.
Aby dodać niestandardowe boksy reklamowe, użyj metody .placeDetailsCompactContentSlot obiektu AdvancedPlaceDetailsCompactView. Dostępne pozycje to .basicSectionTop i .basicSectionBottom.
Wymagania dotyczące podania źródła i sugestie dotyczące treści w boksach treści
Po zamontowaniu niestandardowego boksu na treści komunikat jest automatycznie aktualizowany, aby wyjaśnić, które treści są dostarczane przez Google, a które przez osoby trzecie.
Należy
Zachowaj wyraźną hierarchię wizualną między informacjami o miejscu w Google a treściami niestandardowymi, aby uniknąć niejasności co do źródła informacji.
Należy
Rozważ dostarczanie zlokalizowanych, wartościowych informacji dostosowanych do bezpośrednich celów użytkowników. Dostosowane treści, takie jak okna rezerwacji w czasie rzeczywistym lub aktualna dostępność, pomagają użytkownikom podejmować szybsze i bardziej świadome decyzje.
Przeciwwskazania
Nie powielaj istniejących informacji o miejscu w Google, takich jak oceny, opinie czy godziny otwarcia, nawet jeśli treści dostarczone przez Google zostały ukryte. Może to wprowadzać użytkowników w błąd co do źródła treści i tego, czy pochodzą one od Google czy od innej firmy.
Przeciwwskazania
Nie wyświetlaj nieprzypisanych twierdzeń ani plakietek (np. „Najlepsza rekomendacja!”), które mogą być mylone z oficjalnymi rekomendacjami Google. Treści niestandardowe muszą wyraźnie wskazywać źródło.
Przeciwwskazania
Nie umieszczaj w kontenerach niestandardowych miejsc reklam, tekstów marketingowych, rabatów promocyjnych ani próśb o subskrypcję.
Przykłady zaawansowanych informacji o miejscu
pominąć nazwę miejsca,
Aby pominąć nazwę miejsca, nie uwzględniaj.name w parametrze content w 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))") } } ) } }
Usuwanie przycisków poleceń
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 [] } } }
Dodawanie działań niestandardowych i wstępnie zdefiniowanych
Ten przykład dodaje opcję dodawania miejsca do ulubionych lub usuwania go z ulubionych, a także wstępnie zdefiniowane działanie Otwórz w Mapach.
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) } } }
Filtrowanie opinii i multimediów
Ten przykładowy kod pokazuje tylko multimedia i opinie, które zawierają słowo „kawa”.
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)") } } } }
Tworzenie boksów treści
Ten przykład dodaje treści do boksów basicSectionTop i 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) } } }