Компонент "Расширенный список мест"
Компонент Advanced Place List позволяет задать и показать список мест. Вы можете указать до 20 мест из одного набора идентификаторов, поддерживаемых компонентом «Информация о местах» (идентификаторы мест, названия ресурсов мест или координаты широты и долготы).
Вы можете выбрать горизонтальный или вертикальный список. По умолчанию для скринкаста выбирается вертикальная ориентация. Для каждого элемента списка доступна та же информация и те же параметры конфигурации, что и для компактных и полных карточек с информацией о местах.
Чтобы создать список, используйте параметры orientation, placeIdentifiers и configuration метода AdvancedPlaceListView.
Оплата
Плата взимается за каждый запрос списка, а любое изменение списка считается новым платным событием.
Токены для агентных приложений
Токен визуализации агентских данных позволяет агентскому приложению бесплатно показывать элементы Places UI Kit для мест в ответе инструментов агентов Maps Experience (ранее – Maps Grounding Lite). Подробнее о токене визуализации данных агента…
Пример
В этом примере создается список на основе идентификаторов мест. Параметр configuration указывает, что для каждого элемента списка будет указан адрес, рейтинг и тип, а также другие визуальные характеристики. Основное действие позволяет пользователю добавлять каждый элемент списка в избранное или удалять его оттуда. Действия в углах отключены для каждого элемента списка.
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) } } }