Composant Advanced Place List

Le composant Liste de lieux avancée vous permet de définir et d'afficher une liste de lieux. Vous pouvez lister jusqu'à 20 lieux à partir du même ensemble d'identités compatibles avec le composant Place Details (ID de lieu, noms de ressources de lieu ou coordonnées de latitude/longitude).

Vous pouvez choisir d'afficher la liste à l'horizontale ou à la verticale. L'orientation par défaut est verticale. Les mêmes informations et options de configuration que les fiches Place Details compactes et complètes sont disponibles pour chaque élément de la liste.

Utilisez les paramètres orientation, placeIdentifiers et configuration de AdvancedPlaceListView pour créer une liste.

Facturation

Chaque requête de liste vous est facturée, et toute modification apportée à la liste constitue un nouvel événement facturable.

Jetons pour les applications agentives

Le jeton de visualisation des données agentiques permet à votre application agentique d'afficher les éléments du Kit UI pour Places pour les lieux d'une réponse Maps Experience Agent Tools (anciennement Maps Grounding Lite) sans frais supplémentaires. Pour en savoir plus, consultez Jeton de visualisation des données agentique.

Exemple

Cet exemple crée une liste basée sur des identifiants de lieu. Le paramètre configuration spécifie que chaque élément de la liste affichera l'adresse, la note et le type, ainsi que d'autres spécifications visuelles. Une action principale est créée pour permettre à un utilisateur d'ajouter ou de supprimer chaque élément de la liste de ses favoris. Les actions d'angle sont désactivées pour chaque élément de la liste.

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