רכיב מתקדם של רשימת מקומות

הרכיב "רשימת מקומות מתקדמת" מאפשר להגדיר ולהציג רשימה של מקומות. אפשר להוסיף לרשימה עד 20 מקומות מאותה קבוצת מזהים שנתמכים ברכיב Place Details (מזהי מקומות, שמות של משאבי מקומות או קואורדינטות של קו רוחב/קו אורך).

אתם יכולים לבחור אם להציג את הרשימה בצורה אופקית או אנכית. כיוון ברירת המחדל הוא לאורך. לכל פריט ברשימה יש את אותן אפשרויות מידע והגדרה כמו בכרטיסי פרטי המקום המלאים והמצומצמים.

כדי ליצור רשימה, משתמשים בפרמטרים orientation,‏ placeIdentifiers ו-configuration של AdvancedPlaceListView.

חיוב

אתם מחויבים על כל בקשה לרשימה, וכל שינוי ברשימה הוא אירוע חדש לחיוב.

טוקנים לאפליקציות מבוססות-סוכנים

האסימון להצגה חזותית של נתונים מאפשר לאפליקציה האג'נטית להציג רכיבים של Places UI Kit בשביל המקומות בתשובה של הכלים האג'נטיים בממשק Maps (לשעבר Maps Grounding Lite) ללא עלות נוספת. מידע נוסף זמין במאמר אסימון להמחשה חזותית של נתונים מבוססי-סוכן.

דוגמה

הדוגמה הזו יוצרת רשימה על סמך מזהי מקומות. הפרמטר configuration מציין שכל פריט ברשימה יכלול את הכתובת, הדירוג והסוג, יחד עם מפרטים חזותיים אחרים. פעולה ראשית נוצרת כדי לאפשר למשתמש להוסיף כל פריט ברשימה למועדפים או להסיר אותו מהמועדפים. הפעולות בפינות מושבתות לכל פריט ברשימה.

Swift

  struct AdvancedPlaceListDemoView: View {
  private let configuration = AdvancedPlaceListConfiguration(
    content: [.address(), .rating(), .type()],
    preferTruncation: true,
    theme: PlacesMaterialTheme(),
    attributionPosition: .bottom,
    mediaSize = .medium,
    selectable: true
  )
  @State private var placeIdentifiers = [.placeID("ChIJj61dQgK6j4AR4GeTYWZsKWw")]

  @State private var favoritePlaces: Set<String> = []

  var body: some View {
    AdvancedPlaceListView(
      orientation: .horizontal, // default is vertical
      placeIdentifiers: placeIdentifiers,
      configuration: configuration
    )
    .onLoad { results in
      for result in results {
        switch result {
          case .success(let place)
            print("place: \(place)")
          case .failure(let error)
            print("error: \(error)")
        }
      }
    }
    .onPlaceSelected { place, index in
      print("place: \(place)")
      print("index: \(index)")
    }
    .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
    }
    // Ensures that there are no corner actions.
    .cornerActions { _ in
      return []
    }
  }

  func toggleFavorite(_ placeID: String) {
    if favoritePlaces.contains(placeID) {
      favoritePlaces.remove(placeID)
    } else {
      favoritePlaces.insert(placeID)
    }
  }
}