ऐडवांस प्लेस लिस्ट कॉम्पोनेंट

ऐडवांस प्लेस लिस्ट कॉम्पोनेंट की मदद से, जगहों की सूची तय की जा सकती है और उसे दिखाया जा सकता है. Place Details कॉम्पोनेंट के साथ काम करने वाली आइडेंटिटी के एक ही सेट (जगह के आईडी, जगह के रिसॉर्स के नाम या अक्षांश/देशांतर निर्देशांक) से, ज़्यादा से ज़्यादा 20 जगहों की सूची बनाई जा सकती है.

सूची को हॉरिज़ॉन्टल या वर्टिकल तौर पर दिखाने का विकल्प चुना जा सकता है. डिफ़ॉल्ट रूप से, स्क्रीनकास्ट का ओरिएंटेशन वर्टिकल होता है. सूची में मौजूद हर आइटम के लिए, वही जानकारी और कॉन्फ़िगरेशन के विकल्प उपलब्ध होते हैं जो जगह की जानकारी देने वाले कॉम्पैक्ट और फ़ुल कार्ड के लिए होते हैं.

सूची बनाने के लिए, AdvancedPlaceListView के orientation, placeIdentifiers, और configuration पैरामीटर का इस्तेमाल करें.

बिलिंग

सूची के हर अनुरोध के लिए आपसे शुल्क लिया जाता है. साथ ही, सूची में किया गया कोई भी बदलाव, शुल्क वाला नया इवेंट होता है.

एजेंटिक ऐप्लिकेशन के लिए टोकन

एजेंटिक डेटा विज़ुअलाइज़ेशन टोकन की मदद से, आपका एजेंटिक ऐप्लिकेशन, 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)
    }
  }
}