Gelişmiş Yer Listesi bileşeni

Gelişmiş Yer Listesi bileşeni, bir yer listesi tanımlamanıza ve görüntülemenize olanak tanır. Yer Ayrıntıları bileşeni tarafından desteklenen aynı kimlik grubundan (yer kimlikleri, yer kaynak adları veya enlem/boylam koordinatları) en fazla 20 yer listeleyebilirsiniz.

Yatay veya dikey liste görünümü arasından seçim yapabilirsiniz. Varsayılan yön dikey. Her liste öğesi için yer ayrıntıları kartlarının kompakt ve tam sürümlerindeki bilgiler ve yapılandırma seçenekleri sunulur.

Liste oluşturmak için AdvancedPlaceListView öğesinin orientation, placeIdentifiers ve configuration parametrelerini kullanın.

Faturalandırma

Her liste isteği için faturalandırılırsınız ve listede yapılan her değişiklik, faturalandırılabilir yeni bir etkinliktir.

Temsilci tabanlı uygulamalar için jetonlar

Temsilci tabanlı veri görselleştirme jetonu, temsilci tabanlı uygulamanızın Haritalar deneyimi ajan araçları (eski adıyla Maps Grounding Lite) yanıtındaki yerler için Places UI Kit öğelerini ek ücret ödemeden görüntülemesine olanak tanır. Daha fazla bilgi için Temsilci tabanlı veri görselleştirme jetonu başlıklı makaleyi inceleyin.

Örnek

Bu örnekte, yer tanımlayıcılarına dayalı bir liste oluşturulur. configuration parametresi, her liste öğesinin diğer görsel özelliklerle birlikte adresi, puanı ve türü listeleyeceğini belirtir. Kullanıcının her liste öğesini favorilere eklemesine veya favorilerden kaldırmasına olanak tanıyan bir ana işlem oluşturulur. Köşe işlemleri her liste öğesi için devre dışı bırakılır.

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)
    }
  }
}