Erweiterte Ortslistenkomponente

Mit der Komponente „Erweiterte Ortsliste“ können Sie eine Liste von Orten definieren und anzeigen. Sie können bis zu 20 Orte aus derselben Gruppe von Identitäten auflisten, die von der Komponente „Place Details“ unterstützt werden (Orts-IDs, Ortsressourcennamen oder Breiten-/Längengradkoordinaten).

Sie können zwischen einer horizontalen und einer vertikalen Listenanzeige wählen. Die Standardausrichtung ist vertikal. Für jeden Listeneintrag sind dieselben Informationen und Konfigurationsoptionen wie für die kompakten und vollständigen Place Details-Infokarten verfügbar.

Verwenden Sie die Parameter orientation, placeIdentifiers und configuration von AdvancedPlaceListView, um eine Liste zu erstellen.

Abrechnung

Ihnen wird jede Listenanfrage in Rechnung gestellt. Jede Änderung an der Liste ist ein neues abrechenbares Ereignis.

Tokens für agentische Anwendungen

Mit dem Token für die agentische Datenvisualisierung kann Ihre agentische App Elemente des Places UI Kit für die Orte in einer Antwort der Maps Experience Agent Tools (früher Maps Grounding Lite) ohne zusätzliche Kosten anzeigen. Weitere Informationen finden Sie unter Agentische Datenvisualisierungstoken.

Beispiel

In diesem Beispiel wird eine Liste anhand von Orts-IDs erstellt. Der Parameter configuration gibt an, dass für jedes Listenelement die Adresse, die Bewertung und der Typ sowie andere visuelle Spezifikationen aufgeführt werden. Es wird eine Hauptaktion erstellt, mit der ein Nutzer jedes Listenelement als Favorit markieren oder die Markierung aufheben kann. Eckaktionen sind für jedes Listenelement deaktiviert.

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