“高级地点列表”组件

借助高级地点列表组件,您可以定义和显示地点列表。您最多可以列出 20 个地点,这些地点必须使用地点详情组件支持的同一组标识(地点 ID、地点资源名称或经纬度坐标)。

您可以选择水平或垂直列表显示。默认方向为竖屏。每个列表项都提供与紧凑和完整地点详情卡片相同的信息和配置选项。

使用 AdvancedPlaceListView 的 orientation、placeIdentifiers 和 configuration 参数创建列表。

结算

系统会针对每个列表请求向您收费,并且对列表的任何更改都是新的可计费事件。

智能体应用的 token

借助智能体数据可视化令牌,您的智能体应用可以显示地图体验智能体工具(以前称为 Maps Grounding Lite)响应中地点的 Places UI Kit 元素,而无需支付额外费用。如需了解详情,请参阅智能体数据可视化令牌。

示例

此示例会根据地点标识符创建列表。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)
    }
  }
}