רכיב מתקדם של פרטי מקום
הגרסה המתקדמת של רכיב פרטי המקום כוללת את אותן תכונות כמו גרסת Essentials של פרטי המקום. הוא גם מאפשר לכם:
- בוחרים אם להציג את שם המקום.
- מגדירים את כפתורי הפעולה של הרכיב.
- להפעיל אפשרויות חיפוש וסינון על הביקורות והמדיה שמוצגות.
- ליצור משבצות תוכן בהתאמה אישית.
טוקנים לאפליקציות מבוססות-סוכנים
האסימון להצגה חזותית של נתונים מאפשר לאפליקציה האג'נטית להציג רכיבים של Places UI Kit בשביל המקומות בתשובה של הכלים האג'נטיים בממשק Maps (לשעבר Maps Grounding Lite) ללא עלות נוספת. מידע נוסף זמין במאמר אסימון להמחשה חזותית של נתונים מבוססי-סוכן.
הגדרה מתקדמת של Place Details
כדי לגשת לתכונות המתקדמות, משתמשים ב-AdvancedPlaceDetailsView או ב-AdvancedPlaceDetailsCompactView.
אפשרויות תצוגת התוכן
אתם יכולים לציין איזה תוכן להציג באמצעות ה-enums ב-AdvancedPlaceDetailsContent. אתם יכולים להגדיר את כל התוכן שמופיע ב-Places Details Essentials, וגם לבחור אם שם המקום יוצג.
הגדרת כפתורי פעולה
כדי להסיר או להתאים אישית את כפתורי הפעולות, משתמשים בשיטות .cornerActions ו-.mainActions של AdvancedPlaceDetailsView או AdvancedPlaceDetailsCompactView.
דרישות לייחוס חזותי
חשוב: אתם צריכים להבהיר למשתמשי הקצה מתי כפתור פעולה בהתאמה אישית ישתף מידע של המשתמשים עם צד שלישי שהוא לא Google. ראו דרישות לייחוס חזותי.
בדוגמה שמשמאל מוצגת תמונה מותאמת אישית שמבהירה שפרטי המשתמש יישלחו אל Altostrat.
איך משתמשים באפשרויות החיפוש והסינון
כדי להפעיל חיפוש וסינון של מדיה או ביקורות, משתמשים בשיטות .searchMediaOptions ו-.searchReviewOptions של AdvancedPlaceDetailsView או AdvancedPlaceDetailsCompactView.
יצירת מיקומי תוכן בהתאמה אישית
משבצות תוכן בהתאמה אישית מאפשרות לכם להוסיף תוכן משלכם (כמו סיכומים שנוצרו על ידי AI, חותמות זמן של מסלול נסיעה או תגים בהתאמה אישית) ישירות לאזורי פריסה מוגדרים מראש.
כדי להוסיף מיקומי מודעות מותאמים אישית, משתמשים ב-method .placeDetailsCompactContentSlot של AdvancedPlaceDetailsCompactView. המיקומים הזמינים הם .basicSectionTop ו-.basicSectionBottom.
דרישות ייחוס והצעות לתוכן במשבצות תוכן
כשמשבצת תוכן בהתאמה אישית מותקנת, ההודעה מתעדכנת באופן אוטומטי כדי להבהיר איזה תוכן מסופק על ידי Google ואיזה תוכן מסופק על ידי צדדים שלישיים.
מומלץ
שמרו על היררכיה חזותית ברורה בין פרטי המקומות ב-Google לבין התוכן בהתאמה אישית, כדי למנוע אי-בהירות לגבי מקור המידע.
מומלץ
כדאי להציג תובנות מקומיות ובעלות ערך גבוה שמותאמות ליעדים המיידיים של המשתמשים. תוכן מותאם אישית, כמו חלונות הזמנה בזמן אמת או זמינות נוכחית, עוזר למשתמשים לקבל החלטות מהירות ומושכלות יותר.
מה לא מומלץ לעשות
אסור לשכפל פרטים קיימים של מקומות ב-Google, כמו דירוגים, ביקורות או שעות פעילות, גם אם הסתרתם את התוכן ש-Google סיפקה. זה עלול לבלבל את המשתמשים לגבי מקור התוכן, ולגרום להם לתהות אם הוא מגיע מ-Google או מצד שלישי.
מה לא מומלץ לעשות
אל תציגו טענות או תגים ללא שיוך (לדוגמה, "ההמלצה המובילה!") שעלולים להתפרש בטעות כהמלצות רשמיות של Google. בתוכן בהתאמה אישית צריך לציין במפורש את המקור שלו.
מה לא מומלץ לעשות
אסור לכלול מודעות, תוכן שיווקי, הנחות או בקשות להירשם כמנוי בתוך קונטיינרים של מקומות בהתאמה אישית.
דוגמאות מתקדמות לפרטי מקומות
השמטת שם המקום
כדי להשמיט את שם המקום, אל תכללו את.name בפרמטר content של 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))") } } ) } }
הסרת כפתורי פעולה
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 [] } } }
הוספת פעולות מותאמות אישית ומוגדרות מראש
הדוגמה הזו מוסיפה אפשרות למשתמש להוסיף מקום למועדפים או להסיר אותו מהמועדפים, יחד עם הפעולה המוגדרת מראש פתיחה במפות Google.
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) } } }
סינון ביקורות ומדיה
בדוגמת הקוד הזו מוצגות רק ביקורות ותמונות או סרטונים שמוזכרת בהם המילה "קפה".
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)") } } } }
יצירת משבצות תוכן
הדוגמה הזו מוסיפה תוכן למשבצות basicSectionTop ו-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) } } }