Componente Advanced Place List
Com o componente Lista de Lugares Avançada, você pode definir e mostrar uma lista de lugares. É possível listar até 20 lugares do mesmo conjunto de identidades compatíveis com o componente Place Details (IDs de lugar, nomes de recursos de lugar ou coordenadas de latitude/longitude).
Você pode escolher entre uma exibição de lista horizontal ou vertical. A orientação padrão é vertical. As mesmas informações e opções de configuração dos cards de Place Details compactos e completos estão disponíveis para cada item da lista.
Use os parâmetros orientation, placeIdentifiers e configuration de AdvancedPlaceListView para criar uma lista.
Faturamento
Você recebe uma cobrança por cada solicitação de lista, e qualquer mudança na lista é um novo evento faturável.
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.
Exemplo
Este exemplo cria uma lista com base em identificadores de lugar. O parâmetro configuration especifica que cada item da lista vai mostrar o endereço, a classificação e o tipo, além de outras especificações visuais. Uma ação principal é criada para permitir que o usuário marque ou desmarque cada item da lista como favorito. As ações de canto estão desativadas para cada item da lista.
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) } } }