مكوّن "قائمة الأماكن المتقدّمة"
يتيح لك مكوّن "قائمة الأماكن المتقدّمة" تحديد قائمة بالأماكن وعرضها. يمكنك إدراج ما يصل إلى 20 مكانًا من مجموعة الهويات نفسها التي يتيحها مكوّن "تفاصيل المكان" (أرقام تعريف الأماكن أو أسماء موارد الأماكن أو إحداثيات خطوط العرض/الطول).
يمكنك الاختيار من بين عرض القائمة أفقيًا أو عموديًا. يكون الاتجاه التلقائي عموديًا. تتوفّر لكل عنصر في القائمة المعلومات وخيارات الضبط نفسها المتوفّرة في بطاقات تفاصيل المكان الكاملة والمختصرة.
استخدِم المَعلمات orientation وplaceIdentifiers وconfiguration في AdvancedPlaceListView لإنشاء قائمة.
الفوترة
تتم محاسبتك على كل طلب قائمة، وأي تغيير في القائمة هو حدث جديد تتم محاسبتك عليه.
الرموز المميّزة للتطبيقات المستندة إلى الذكاء الاصطناعي الوكيل
يتيح الرمز المميّز للعرض المرئي للبيانات المستند إلى الوكلاء لتطبيقك المستند إلى الوكلاء عرض عناصر حزمة أدوات "خرائط Google" الجاهزة للأماكن في ردّ "أدوات تجربة الخرائط للوكلاء" (المعروفة سابقًا باسم 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) } } }