مؤلفه «فهرست مکان پیشرفته»

مؤلفه «فهرست مکان پیشرفته» به شما امکان می‌دهد فهرستی از مکان‌ها را تعریف و نمایش دهید. می‌توانید حداکثر ۲۰ مکان را از همان مجموعه شناسه‌های پشتیبانی‌شده توسط مؤلفه «جزئیات جا» (شناسه‌های جا، نام‌های منبع جا، یا مختصات طول/عرض جغرافیایی) فهرست کنید.

می‌توانید از بین نمایش فهرست افقی یا عمودی انتخاب کنید. جهت پیش‌فرض عمودی است. همان اطلاعات و گزینه‌های پیکربندی کارت‌های جزئیات مکان فشرده و کامل برای هر مورد فهرست دردسترس است.

از پارامترهای orientation، placeIdentifiers، و configuration از AdvancedPlaceListView برای ایجاد فهرست استفاده کنید.

صورت‌حساب

برای هر درخواست فهرست صورت‌حساب دریافت می‌کنید و هرگونه تغییر در فهرست یک رویداد جدید قابل‌صورت‌حساب است.

کدها برای برنامه‌های عامل‌گرا

بااستفاده از کد دیداری‌سازی داده‌های عامل، برنامه عامل شما می‌تواند عناصر «کیت میانای کاربر جاها» را برای مکان‌های موجود در پاسخ ابزارهای عامل Maps Experience (‏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)
    }
  }
}