Thành phần Danh sách địa điểm nâng cao

Thành phần Danh sách địa điểm nâng cao cho phép bạn xác định và hiển thị danh sách địa điểm. Bạn có thể liệt kê tối đa 20 địa điểm từ cùng một nhóm giá trị nhận dạng được thành phần Chi tiết địa điểm hỗ trợ (Mã địa điểm, Tên tài nguyên địa điểm hoặc toạ độ vĩ độ/kinh độ).

Bạn có thể chọn hiển thị danh sách theo chiều ngang hoặc chiều dọc. Hướng mặc định là hướng dọc. Mỗi mục trong danh sách đều có thông tin và các lựa chọn cấu hình giống như thẻ thông tin chi tiết về địa điểm thu gọn và đầy đủ.

Sử dụng các tham số orientation, placeIdentifiers và configuration của AdvancedPlaceListView để tạo danh sách.

Thanh toán

Bạn sẽ bị tính phí cho mỗi yêu cầu về danh sách và mọi thay đổi đối với danh sách đều là một sự kiện mới có tính phí.

Mã thông báo cho ứng dụng tác nhân

Mã thông báo trực quan hoá dữ liệu dựa trên tác nhân cho phép ứng dụng dựa trên tác nhân của bạn hiển thị các thành phần của Places UI Kit cho các địa điểm trong phản hồi của các công cụ tác nhân cho trải nghiệm trên Maps (trước đây là Maps Grounding Lite) mà không mất thêm phí. Để biết thêm thông tin, hãy xem bài viết Mã thông báo trực quan hoá dữ liệu của tác nhân.

Ví dụ

Mẫu này tạo một danh sách dựa trên giá trị nhận dạng địa điểm. Tham số configuration chỉ định rằng mỗi mục trong danh sách sẽ liệt kê địa chỉ, điểm xếp hạng và loại, cùng với các thông số kỹ thuật hình ảnh khác. Một thao tác chính được tạo để cho phép người dùng thêm hoặc bỏ thích từng mục trong danh sách. Thao tác ở góc bị tắt đối với từng mục trong danh sách.

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)
    }
  }
}