Composant Advanced Place Details

La version Advanced du composant Place Details offre les mêmes fonctionnalités que Places Details Essentials. Il vous permet également de :

  • Choisissez si le nom du lieu est affiché.
  • Configurez les boutons d'action du composant.
  • Appliquez des options de recherche et de filtrage aux avis et aux contenus multimédias affichés.
  • Créez des emplacements de contenu personnalisés.

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.

Configuration avancée de Place Details

Utilisez AdvancedPlaceDetailsView ou AdvancedPlaceDetailsCompactView pour accéder aux fonctionnalités avancées.

Options d'affichage du contenu

Vous pouvez spécifier le contenu à afficher à l'aide des énumérations dans AdvancedPlaceDetailsContent. Vous pouvez configurer le même contenu que pour Places Details Essentials et choisir d'afficher ou non le nom du lieu.

Configurer les boutons d'action

Utilisez les méthodes .cornerActions et .mainActions de AdvancedPlaceDetailsView ou AdvancedPlaceDetailsCompactView pour supprimer ou personnaliser les boutons d'action.

Exigences d'attribution visuelle

Vue compacte de Place Details avec des boutons personnalisables
Vue compacte de Place Details (Advanced) avec un bouton personnalisé

Important : Vous devez indiquer clairement aux utilisateurs finaux quand un bouton d'action personnalisé partagera des informations utilisateur avec un tiers autre que Google. Consultez les exigences concernant l'attribution visuelle.

L'exemple de droite montre une image personnalisée qui indique clairement que les informations utilisateur seront envoyées à "Altostrat".

Appliquer des options de recherche et de filtrage

Utilisez les méthodes .searchMediaOptions et .searchReviewOptions de AdvancedPlaceDetailsView ou AdvancedPlaceDetailsCompactView pour activer la recherche et le filtrage des contenus multimédias ou des avis.

Créer des emplacements de contenu personnalisés

Options d'emplacement des espaces publicitaires personnalisés

Les emplacements de contenu personnalisés vous permettent d'ajouter votre propre contenu (comme des résumés générés par l'IA, des codes temporels d'itinéraire ou des badges personnalisés) directement dans des zones de mise en page prédéfinies.

Pour ajouter des emplacements de contenu personnalisés, utilisez la méthode .placeDetailsCompactContentSlot de AdvancedPlaceDetailsCompactView. Les positions disponibles sont .basicSectionTop et .basicSectionBottom.

Exigences d'attribution et suggestions de contenu pour les emplacements de contenu

Lorsqu'un emplacement de contenu personnalisé est installé, la mention est automatiquement mise à jour pour indiquer quel contenu est fourni par Google et quel contenu est fourni par des tiers.

À faire

Maintenez une hiérarchie visuelle claire entre les détails Google Places et le contenu personnalisé pour éviter toute ambiguïté sur la source des informations.

Éviter toute ambiguïté sur la source des informations

À faire

Envisagez de proposer des insights localisés et à forte valeur ajoutée, adaptés aux objectifs immédiats de vos utilisateurs. Des contenus personnalisés, tels que des fenêtres de réservation en temps réel ou la disponibilité actuelle, aident les utilisateurs à prendre des décisions plus rapides et plus éclairées.

Fournir des insights de grande valeur

À éviter

Ne dupliquez pas les détails des lieux Google existants, tels que les notes, les avis ou les horaires d'ouverture, même si vous avez masqué le contenu fourni par Google. Cela peut prêter à confusion quant à la source du contenu et à sa provenance (Google ou un tiers).

Ne dupliquez pas les détails d'un lieu Google existant.

À éviter

N'affichez pas d'affirmations ni de badges non attribués (par exemple, "Meilleure recommandation") qui pourraient être confondus avec des recommandations officielles de Google. Le contenu personnalisé doit explicitement attribuer sa source.

N'affichez pas d'allégations ni de badges non attribués

À éviter

N'incluez pas d'annonces, de textes marketing, de remises promotionnelles ni d'invites d'abonnement dans les conteneurs de lieux personnalisés.

N'incluez pas d'annonces, de textes marketing, de remises promotionnelles ni d'invites d'abonnement.

Exemples avancés de Place Details

Omettre le nom du lieu

Pour omettre le nom du lieu, n'incluez pas .name dans le paramètre content de AdvancedPlaceDetailsConfiguration.

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  // Query for loading the place details component.
  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  @State private var favoritePlaces: Set<String> = []

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content:[.address()],
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { result in
        if let place = result.place {
          print("Place: \(place.description)")
        } else {
          print("Error: \(String(describing: result.error))")
        }
      }
    )
  }
}

Supprimer les boutons d'action

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content: AdvancedPlaceDetailsView.allContent,
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { result in
        if let place = result.place {
          print("Place: \(place.description)")
        } else {
          print("Error: \(String(describing: result.error))")
        }
      }
    )
    .mainActions{ _ in
      return []
    }
  }
}

Ajouter des actions personnalisées et prédéfinies

Cet exemple ajoute une option permettant à un utilisateur d'ajouter un lieu à ses favoris ou de le supprimer, ainsi que l'action prédéfinie Ouvrir dans Maps.

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  
  @State var favoritePlaces: Set<String> = []

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content: AdvancedPlaceDetailsView.allContent,
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { result in
        if let place = result.place {
          print("Place: \(place.description)")
        } else {
          print("Error: \(String(describing: result.error))")
        }
      }
    )
    .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
    }
    .cornerActions { place in
      var actions: [CornerPlaceActionElement] = []
      let placeID = place.placeID!
      if self.favoritePlaces.contains(placeID) {
        actions.append(
          .action(
            CornerPlaceAction(
              image: Image(systemName: "heart.fill"),
              accessibilityLabel: "Unfavorite",
            ) { _ in self.toggleFavorite(placeID) }
          )
        )
      } else {
        actions.append(
          .action(
            CornerPlaceAction(
              image: Image(systemName: "heart"),
              accessibilityLabel: "Favorite",
            ) { _ in self.toggleFavorite(placeID) }
          )
        )
      }
      actions.append(.actionId(.openMap(style: .primary)))
      return actions
    }
  }

  func toggleFavorite(_ placeID: String) {
    if favoritePlaces.contains(placeID) {
      favoritePlaces.remove(placeID)
    } else {
      favoritePlaces.insert(placeID)
    }
  }
}

Filtrer les avis et les contenus multimédias

Cet exemple de code ne montre que les contenus multimédias et les avis qui mentionnent "café".

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  let searchMediaOptions = SearchMediaOptions(query: "coffee")
  let searchReviewsOptions = SearchReviewsOptions(query: "coffee")

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content: [.media(), .reviews()],
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { _ in }
    )
    .searchMediaOptions(searchMediaOptions) { results in
      guard let result = results.first else { return }
      switch result {
      case .success(let summary):
        print("Summary: \(summary)")
      case .failure(let error):
        print("Error: \(error)")
      }
    }
    .searchReviewsOptions(searchReviewsOptions) { results in
      guard let result = results.first else { return }
      switch result {
      case .success(let summary):
        print("Summary: \(summary)")
      case .failure(let error):
        print("Error: \(error)")
      }
    }
  }
}

Créer des emplacements de contenu

Cet exemple ajoute du contenu aux emplacements basicSectionTop et basicSectionBottom.

Swift

import SwiftUI
import PlacesSwift

struct ItineraryCard: View {
    static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

    @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
      identifier: .placeID(peetsCoffeePlaceID)
    )

    var body: some View {
      AdvancedPlaceDetailsCompactView(
        orientation: .vertical,
        query: $query,
        configuration: AdvancedPlaceDetailsCompactConfiguration(
          content: AdvancedPlaceDetailsCompactView.allContent,
          theme: PlacesMaterialTheme()
        ),
        placeDetailsCallback: { _ in }
      )
      .placeDetailsCompactContentSlot(position: .basicSectionTop) { place in
        Text("Day 2 • 2:30 PM")
          .font(.caption)
          .fontWeight(.bold)
          .foregroundColor(.accentColor)
      }
      .placeDetailsCompactContentSlot(position: .basicSectionBottom) { place in
        VStack(alignment: .leading, spacing: 4) {
          Text("AI Notes")
            .font(.caption)
            .bold()
          Text("Great quiet atmosphere for morning meetings. Famous for house-roasted pour-overs.")
            .font(.footnote)
            .foregroundColor(.secondary)
        }
        .padding(8)
        .background(Color(.systemGray6))
        .cornerRadius(8)
      }
    }
}