Componente Place Details Advanced

A versão Advanced do componente Place Details oferece os mesmos recursos do Places Details Essentials. Ele também permite:

  • Escolha se o nome do lugar será exibido.
  • Configure os botões de ação do componente.
  • Aplicar opções de pesquisa e filtragem às avaliações e mídias mostradas.
  • Criar espaços de conteúdo personalizados.

Tokens para apps agênticos

O token de visualização de dados agênticos permite que seu app agêntico mostre elementos do Kit de Interface do Places para os lugares em uma resposta da ferramenta de agentes Maps Experience (antigo Maps Grounding Lite) sem custo financeiro adicional. Para mais informações, consulte Token de visualização de dados de agentes.

Configuração avançada do Place Details

Use AdvancedPlaceDetailsView ou AdvancedPlaceDetailsCompactView para acessar recursos avançados.

Opções de exibição de conteúdo

É possível especificar qual conteúdo mostrar usando os tipos enumerados em AdvancedPlaceDetailsContent. É possível configurar todo o conteúdo de Places Details Essentials e escolher se o nome do lugar será exibido.

Configurar botões de ação

Use os métodos .cornerActions e .mainActions de AdvancedPlaceDetailsView ou AdvancedPlaceDetailsCompactView para remover ou personalizar os botões de ação.

Requisitos de atribuição visual

Visualização compacta de Place Details com botões personalizáveis
Visualização compacta do Advanced Place Details com botão personalizável

Importante: você precisa deixar claro para os usuários finais quando um botão de ação personalizada compartilhar informações do usuário com terceiros que não sejam o Google. Consulte os requisitos de atribuição visual.

O exemplo à direita mostra uma imagem personalizada que deixa claro que as informações do usuário serão enviadas para "Altostrat".

Aplicar opções de pesquisa e filtragem

Use os métodos .searchMediaOptions e .searchReviewOptions de AdvancedPlaceDetailsView ou AdvancedPlaceDetailsCompactView para ativar a pesquisa e a filtragem de mídias ou avaliações.

Criar espaços de conteúdo personalizados

Opções de posicionamento de espaços de conteúdo personalizados

Com os espaços de conteúdo personalizado, você pode adicionar seu próprio conteúdo (como resumos gerados por IA, marcações de tempo de itinerário ou selos personalizados) diretamente em zonas de layout predefinidas.

Para adicionar espaços de conteúdo personalizados, use o método .placeDetailsCompactContentSlot de AdvancedPlaceDetailsCompactView. As posições disponíveis são .basicSectionTop e .basicSectionBottom.

Requisitos de atribuição e sugestões de conteúdo para espaços de conteúdo

Quando um espaço de conteúdo personalizado é montado, a declaração é atualizada automaticamente para esclarecer qual conteúdo é fornecido pelo Google e que parte dele é fornecida por terceiros.

O que fazer

Mantenha uma hierarquia visual clara entre os detalhes do Google Place e o conteúdo personalizado para evitar qualquer ambiguidade sobre a origem das informações.

Evitar ambiguidade sobre a fonte de informações

O que fazer

Considere insights localizados e de alto valor, adaptados às metas imediatas dos usuários. Conteúdo personalizado, como janelas de reserva em tempo real ou disponibilidade atual, ajuda os usuários a tomar decisões mais rápidas e informadas.

Fornecer insights de alto valor

O que não fazer

Não duplique os Place Details existentes do Google, como classificações, avaliações ou horário de funcionamento, mesmo que você tenha ocultado o conteúdo fornecido pelo Google. Isso pode confundir os usuários sobre a origem do conteúdo e se ele vem do Google ou de terceiros.

Não duplique os detalhes de um lugar do Google

O que não fazer

Não mostre declarações ou selos sem atribuição (por exemplo, "Melhor recomendação!") que possam ser confundidos com endossos oficiais do Google. O conteúdo personalizado precisa atribuir explicitamente a fonte.

Não mostre declarações ou selos sem atribuição

O que não fazer

Não inclua anúncios, textos de marketing, descontos promocionais ou solicitações de assinatura em contêineres de lugares personalizados.

Não inclua anúncios, textos de marketing, descontos promocionais ou solicitações de assinatura.

Exemplos avançados de Place Details

Omitir o nome do lugar

Para omitir o nome do lugar, não inclua .name no parâmetro 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))")
        }
      }
    )
  }
}

Remover botões de ação

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 []
    }
  }
}

Adicionar ações personalizadas e predefinidas

Este exemplo adiciona uma opção para o usuário marcar ou remover dos favoritos um lugar, além da ação predefinida Abrir no 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)
    }
  }
}

Filtrar avaliações e mídia

Este exemplo de código mostra apenas mídias e avaliações que mencionam "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)")
      }
    }
  }
}

Criar slots de conteúdo

Este exemplo adiciona conteúdo aos slots basicSectionTop e 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)
      }
    }
}