Componente Place List avanzato

Il componente Elenco di luoghi avanzato ti consente di definire e visualizzare un elenco di luoghi. Puoi elencare fino a 20 luoghi dello stesso insieme di identità supportate dal componente Place Details (ID luogo, nomi delle risorse dei luoghi o coordinate di latitudine/longitudine).

Puoi scegliere tra una visualizzazione dell'elenco orizzontale o verticale. L'orientamento predefinito è verticale. Per ogni elemento dell'elenco sono disponibili le stesse informazioni e opzioni di configurazione delle schede dei dettagli dei luoghi compatte e complete.

Utilizza i parametri orientation, placeIdentifiers e configuration di AdvancedPlaceListView per creare un elenco.

Fatturazione

Ti viene addebitato un costo per ogni richiesta di elenco e ogni modifica all'elenco è un nuovo evento fatturabile.

Token per app agentiche

Il token di visualizzazione dei dati agentici consente alla tua app agentica di visualizzare gli elementi di Places UI Kit per i luoghi in una risposta dei tool agentici di Maps Experience (precedentemente Maps Grounding Lite) senza costi aggiuntivi. Per saperne di più, consulta Token di visualizzazione dei dati degli agenti.

Esempio

Questo esempio crea un elenco basato sugli identificatori dei luoghi. Il parametro configuration specifica che ogni elemento dell'elenco mostrerà l'indirizzo, la valutazione e il tipo, insieme ad altre specifiche visive. Viene creata un'azione principale per consentire a un utente di aggiungere o rimuovere ogni elemento dell'elenco dai preferiti. Le azioni degli angoli sono disattivate per ogni elemento dell'elenco.

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